Laravel框架表單驗(yàn)證詳解
基礎(chǔ)驗(yàn)證例子
$validator = Validator::make(
array('name' => 'Dayle'),
array('name' => 'required|min:5')
);
傳遞給 make 函數(shù)的第一個參數(shù)是待驗(yàn)證的數(shù)據(jù)，第二個參數(shù)是對該數(shù)據(jù)需要應(yīng)用的驗(yàn)證規(guī)則。
多個驗(yàn)證規(guī)則可以通過 "|" 字符進(jìn)行隔開，或者作為數(shù)組的一個單獨(dú)的元素。
通過數(shù)組指定驗(yàn)證規(guī)則
$validator = Validator::make(
array('name' => 'Dayle'),
array('name' => array('required', 'min:5'))
);
一旦一個 Validator 實(shí)例被創(chuàng)建，可以使用 fails (或者 passes)函數(shù)執(zhí)行這個驗(yàn)證。
if ($validator->fails())
{
// The given data did not pass validation
}
如果驗(yàn)證失敗，您可以從驗(yàn)證器中獲取錯誤消息。
$messages = $validator->messages();
您也可以使用 failed 函數(shù)得到不帶錯誤消息的沒有通過驗(yàn)證的規(guī)則的數(shù)組。
$failed = $validator->failed();
文件驗(yàn)證
Validator 類提供了一些驗(yàn)證規(guī)則用于驗(yàn)證文件，比如 size、mimes等。在驗(yàn)證文件的時候，您可以和其他驗(yàn)證一樣傳遞給驗(yàn)證器。
附帶錯誤消息
在一個 Validator 實(shí)例上調(diào)用 messages 函數(shù)之后，將會得到一個 MessageBag 實(shí)例，該實(shí)例擁有很多處理錯誤消息的方便的函數(shù)。
獲取一個域的第一個錯誤消息
echo $messages->first('email');
獲取一個域的全部錯誤消息
foreach ($messages->get('email') as $message)
{
//
}
獲取全部域的全部錯誤消息
foreach ($messages->all() as $message)
{
//
}
檢查一個域是否存在消息
if ($messages->has('email'))
{
//
}
以某種格式獲取一條錯誤消息
echo $messages->first('email', '<p>:message</p>');
注意: 默認(rèn)情況下，消息將使用與 Bootstrap 兼容的語法進(jìn)行格式化。
以某種格式獲取所有錯誤消息
foreach ($messages->all('<li>:message</li>') as $message)
{
//
}
錯誤消息 & 視圖
一旦您執(zhí)行了驗(yàn)證，您需要一種簡單的方法向視圖反饋錯誤消息。這在 Lavavel 中能夠方便的處理。以下面的路由作為例子：
Route::get('register', function()
{
return View::make('user.register');
});
Route::post('register', function()
{
$rules = array(...);
$validator = Validator::make(Input::all(), $rules);
if ($validator->fails())
{
return Redirect::to('register')->withErrors($validator);
}
});
注意當(dāng)驗(yàn)證失敗，我們使用 withErrors 函數(shù)把 Validator 實(shí)例傳遞給 Redirect。這個函數(shù)將刷新 Session 中保存的錯誤消息，使得在下次請求中能夠可用。
然而，注意我們沒有必要明確的在 GET 路由中綁定錯誤消息到路由。這是因?yàn)?Laravel 總會檢查 Session 中的錯誤，并自動綁定它們到視圖如果它們是可用的。所以，對于每個請求，一個 $errors 變量在所有視圖中總是可用的，允許您方便的認(rèn)為 $errors 總是被定義并可以安全使用的。$errors 變量將是一個 MessageBag 類的實(shí)例。
所以，在跳轉(zhuǎn)之后，您可以在視圖中使用自動綁定的 $errors 變量：
<?php echo $errors->first('email'); ?>
可用的驗(yàn)證規(guī)則
下面是一個所有可用的驗(yàn)證規(guī)則的列表以及它們的功能：
Accepted
Active URL
After (Date)
Alpha
Alpha Dash
Alpha Numeric
Before (Date)
Between
Confirmed
Date
Date Format
Different
Exists (Database)
Image (File)
In
Integer
IP Address
Max
MIME Types
Min
Not In
Numeric
Regular Expression
Required
Required If
Required With
Required Without
Same
Size
Unique (Database)
accepted
驗(yàn)證此規(guī)則的值必須是 yes、 on 或者是 1。這在驗(yàn)證是否同意"服務(wù)條款"的時候非常有用。
active_url
驗(yàn)證此規(guī)則的值必須是一個合法的 URL，根據(jù) PHP 函數(shù) checkdnsrr。
after:date
驗(yàn)證此規(guī)則的值必須在給定日期之后，日期將通過 PHP 函數(shù) strtotime 傳遞。
alpha
驗(yàn)證此規(guī)則的值必須全部由字母字符構(gòu)成。
alpha_dash
驗(yàn)證此規(guī)則的值必須全部由字母、數(shù)字、中劃線或下劃線字符構(gòu)成。
alpha_num
驗(yàn)證此規(guī)則的值必須全部由字母和數(shù)字構(gòu)成。
before:date
驗(yàn)證此規(guī)則的值必須在給定日期之前，日期將通過 PHP 函數(shù) strtotime 傳遞。
between:min,max
驗(yàn)證此規(guī)則的值必須在給定的 min 和 max 之間。字符串、數(shù)字以及文件都將使用大小規(guī)則進(jìn)行比較。
confirmed
驗(yàn)證此規(guī)則的值必須和 foo_confirmation 的值相同。比如，需要驗(yàn)證此規(guī)則的域是 password，那么在輸入中必須有一個與之相同的 password_confirmation 域。
date
驗(yàn)證此規(guī)則的值必須是一個合法的日期，根據(jù) PHP 函數(shù) strtotime。
date_format:format
驗(yàn)證此規(guī)則的值必須符合給定的 format 的格式，根據(jù) PHP 函數(shù) date_parse_from_format。
different:field
驗(yàn)證此規(guī)則的值必須與指定的 field 域的值不同。
email
驗(yàn)證此規(guī)則的值必須是一個合法的電子郵件地址。
exists:table,column
驗(yàn)證此規(guī)則的值必須在指定的數(shù)據(jù)庫的表中存在。
Exists 規(guī)則的基礎(chǔ)使用
指定列名
'state' => 'exists:states,abbreviation'
您也可以指定更多的條件，將以 "where" 的形式添加到查詢。
'email' => 'exists:staff,email,account_id,1'
image
驗(yàn)證此規(guī)則的值必須是一個圖片 (jpeg, png, bmp 或者 gif)。
in:foo,bar,...
驗(yàn)證此規(guī)則的值必須在給定的列表中存在。
integer
驗(yàn)證此規(guī)則的值必須是一個整數(shù)。
驗(yàn)證此規(guī)則的值必須是一個合法的 IP 地址。
max:value
驗(yàn)證此規(guī)則的值必須小于最大值 value。字符串、數(shù)字以及文件都將使用大小規(guī)則進(jìn)行比較。
mimes:foo,bar,...
驗(yàn)證此規(guī)則的文件的 MIME 類型必須在給定的列表中。
MIME 規(guī)則的基礎(chǔ)使用
'photo' => 'mimes:jpeg,bmp,png'
min:value
驗(yàn)證此規(guī)則的值必須大于最小值 value。字符串、數(shù)字以及文件都將使用大小規(guī)則進(jìn)行比較。
not_in:foo,bar,...
驗(yàn)證此規(guī)則的值必須在給定的列表中不存在。
numeric
驗(yàn)證此規(guī)則的值必須是一個數(shù)字。
regex:pattern
驗(yàn)證此規(guī)則的值必須符合給定的正則表達(dá)式。
注意: 當(dāng)使用 regex 模式的時候，有必要使用數(shù)組指定規(guī)則，而不是管道分隔符，特別是正則表達(dá)式中包含一個管道字符的時候。
required
驗(yàn)證此規(guī)則的值必須在輸入數(shù)據(jù)中存在。
required_if:field,value
當(dāng)指定的域?yàn)槟硞€值的時候，驗(yàn)證此規(guī)則的值必須存在。
required_with:foo,bar,...
僅當(dāng)指定的域存在的時候，驗(yàn)證此規(guī)則的值必須存在。
required_without:foo,bar,...
僅當(dāng)指定的域不存在的時候，驗(yàn)證此規(guī)則的值必須存在。
same:field
驗(yàn)證此規(guī)則的值必須與給定域的值相同。
size:value
驗(yàn)證此規(guī)則的值的大小必須與給定的 value 相同。對于字符串，value 代表字符的個數(shù);對于數(shù)字，value 代表它的整數(shù)值，對于文件，value 代表文件以KB為單位的大小。
unique:table,column,except,idColumn
驗(yàn)證此規(guī)則的值必須在給定的數(shù)據(jù)庫的表中唯一。如果 column 沒有被指定，將使用該域的名字。
Unique 規(guī)則的基礎(chǔ)使用
'email' => 'unique:users'
指定列名
'email' => 'unique:users,email_address'
強(qiáng)制忽略一個給定的 ID
'email' => 'unique:users,email_address,10'
url
驗(yàn)證此規(guī)則的值必須是一個合法的 URL。
定制錯誤消息
如果有需要，您可以使用定制的錯誤消息代替默認(rèn)的消息。這里有好幾種定制錯誤消息的方法。
傳遞定制消息到驗(yàn)證器
$messages = array(
'required' => 'The :attribute field is required.',
);
$validator = Validator::make($input, $rules, $messages);
注意: :attribute 占位符將被實(shí)際的進(jìn)行驗(yàn)證的域的名字代替，您也可以在錯誤消息中使用其他占位符。
其他驗(yàn)證占位符
$messages = array(
'same' => 'The :attribute and :other must match.',
'size' => 'The :attribute must be exactly :size.',
'between' => 'The :attribute must be between :min - :max.',
'in' => 'The :attribute must be one of the following types:
:values',
);
有些時候，您可能希望只對一個指定的域指定定制的錯誤消息：
對一個指定的域指定定制的錯誤消息
$messages = array(
'email.required' => 'We need to know your e-mail address!',
);
在一些情況下，您可能希望在一個語言文件中指定錯誤消息而不是直接傳遞給 Validator。為了實(shí)現(xiàn)這個目的，請?jiān)?app/lang/xx/validation.php 文件中添加您的定制消息到 custom 數(shù)組。
在語言文件中指定錯誤消息
'custom' => array(
'email' => array(
'required' => 'We need to know your e-mail address!',
),
),
定制驗(yàn)證規(guī)則
Laravel 提供了一系列的有用的驗(yàn)證規(guī)則;但是，您可能希望添加自己的驗(yàn)證規(guī)則。其中一種方法是使用 Validator::extend 函數(shù)注冊定制的驗(yàn)證規(guī)則：
注冊一個定制的驗(yàn)證規(guī)則
Validator::extend('foo', function($attribute, $value, $parameters)
{
return $value == 'foo';
});
注意: 傳遞給 extend 函數(shù)的規(guī)則的名字必須符合 "snake cased" 命名規(guī)則。
定制的驗(yàn)證器接受三個參數(shù)：待驗(yàn)證屬性的名字、待驗(yàn)證屬性的值以及傳遞給這個規(guī)則的參數(shù)。
您也可以傳遞一個類的函數(shù)到 extend 函數(shù)，而不是使用閉包：
Validator::extend('foo', 'FooValidator@validate');
注意您需要為您的定制規(guī)則定義錯誤消息。您既可以使用一個行內(nèi)的定制消息數(shù)組，也可以在驗(yàn)證語言文件中進(jìn)行添加。
您也可以擴(kuò)展 Validator 類本身，而不是使用閉包回調(diào)擴(kuò)展驗(yàn)證器。為了實(shí)現(xiàn)這個目的，添加一個繼承自 Illuminate\Validation\Validator 的驗(yàn)證器類。您可以添加在類中添加以 validate 開頭的驗(yàn)證函數(shù)：
擴(kuò)展驗(yàn)證器類
<?php
class CustomValidator extends Illuminate\Validation\Validator {
public function validateFoo($attribute, $value, $parameters)
{
return $value == 'foo';
}
}
下面，您需要注冊定制的驗(yàn)證器擴(kuò)展：
您需要注冊定制的驗(yàn)證器擴(kuò)展
Validator::resolver(function($translator, $data, $rules, $messages)
{
return new CustomValidator($translator, $data, $rules, $messages);
});
當(dāng)創(chuàng)建一個定制的驗(yàn)證規(guī)則，您有時需要為錯誤消息定義一個定制的占位符。為了實(shí)現(xiàn)它，您可以像上面那樣創(chuàng)建一個定制的驗(yàn)證器，并且在驗(yàn)證器中添加一個 replaceXXX 函數(shù)：
protected function replaceFoo($message, $attribute, $rule, $parameters)
{
return str_replace(':foo', $parameters[0], $message);
}
- Laravel學(xué)習(xí)教程之從入口到輸出過程詳解
- Laravel框架源碼解析之反射的使用詳解
- Laravel源碼解析之路由的使用和示例詳解
- 通過源碼解析Laravel的依賴注入
- 源碼分析 Laravel 重復(fù)執(zhí)行同一個隊(duì)列任務(wù)的原因
- Laravel框架數(shù)據(jù)庫CURD操作、連貫操作總結(jié)
- PHP開發(fā)框架Laravel數(shù)據(jù)庫操作方法總結(jié)
- Laravel框架中擴(kuò)展函數(shù)、擴(kuò)展自定義類的方法
- Laravel框架路由配置總結(jié)、設(shè)置技巧大全
- PHP的Laravel框架中使用消息隊(duì)列queue及異步隊(duì)列的方法
- PHP框架Laravel插件Pagination實(shí)現(xiàn)自定義分頁
- Laravel 5框架學(xué)習(xí)之向視圖傳送數(shù)據(jù)
- Laravel框架源碼解析之入口文件原理分析
相關(guān)文章
微信公眾號OAuth2.0網(wǎng)頁授權(quán)問題淺析
根據(jù)需求，我今天完成的是微信的網(wǎng)頁授權(quán)然后拉取用戶的一些基本信息的問題。具體內(nèi)容詳情大家通過本文學(xué)習(xí)吧2017-01-01
詳解在YII2框架中使用UEditor編輯器發(fā)布文章
這篇文章主要介紹了在YII2框架中使用UEditor編輯器發(fā)布文章,小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-11-11
基于Laravel 5.2 regex驗(yàn)證的正確寫法
今天小編就為大家分享一篇基于Laravel 5.2 regex驗(yàn)證的正確寫法，具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-09-09
Laravel框架學(xué)習(xí)筆記（一）環(huán)境搭建
本文主要是把自己學(xué)習(xí)Laravel框架中的經(jīng)驗(yàn)寫下來。這是本系列的第一篇，工欲善其事必先利其器，先把環(huán)境搭建好吧，之前也沒寫過什么文章，可能文章結(jié)構(gòu)比較混亂，想到那寫到哪。2014-10-10
PHP中通過getopt解析GNU C風(fēng)格命令行選項(xiàng)
這篇文章主要介紹了PHP中通過getopt解析GNU C風(fēng)格命令行選項(xiàng)，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-11-11
這篇文章主要介紹了yii框架搜索分頁modle寫法，非常不錯，具有參考借鑒價(jià)值，需要的朋友可以參考下2016-12-12
PHP中字符串中的字符可以通過一個以0為開始的，用類似數(shù)組結(jié)構(gòu)中的方括號包含對應(yīng)的數(shù)字來查找和修改，2014-03-03
這篇文章主要介紹了thinkPHP框架中執(zhí)行事務(wù)的方法,結(jié)合實(shí)例形式分析了thinkPHP框架中使用模型中封裝的startTran()、Commit()及Rollback()方法執(zhí)行事務(wù)與回滾操作相關(guān)實(shí)現(xiàn)技巧,需要的朋友可以參考下2018-05-05
這篇文章主要介紹了thinkPHP的表達(dá)式查詢用法,結(jié)合實(shí)例形式分析了thinkPHP表達(dá)式查詢的格式及相關(guān)運(yùn)算符用法,需要的朋友可以參考下2016-09-09
PHP實(shí)現(xiàn)上傳圖片到 zimg 服務(wù)器
zimg是一個具有圖片處理功能的圖片存儲服務(wù),你可以上傳圖片到zimg服務(wù)器,然后通過帶有參數(shù)的URL來獲取被處理過的圖片，今天我們的主要內(nèi)容是使用php實(shí)現(xiàn)圖片上傳到zimg服務(wù)器上，希望大家能夠喜歡2016-10-10