|
|
基礎(chǔ)驗證例子
復(fù)制代碼 代碼如下:
$validator = Validator::make(
array('name' => 'Dayle'),
array('name' => 'required|min:5')
);
傳遞給 make 函數(shù)的第一個參數(shù)是待驗證的數(shù)據(jù)，第二個參數(shù)是對該數(shù)據(jù)需要應(yīng)用的驗證規(guī)則。
多個驗證規(guī)則可以通過 "|" 字符進(jìn)行隔開，或者作為數(shù)組的一個單獨的元素。
通過數(shù)組指定驗證規(guī)則
復(fù)制代碼 代碼如下:
$validator = Validator::make(
array('name' => 'Dayle'),
array('name' => array('required', 'min:5'))
);
一旦一個 Validator 實例被創(chuàng)建，可以使用 fails (或者 passes)函數(shù)執(zhí)行這個驗證。
復(fù)制代碼 代碼如下:
if ($validator->fails())
{
// The given data did not pass validation
}
如果驗證失敗，您可以從驗證器中獲取錯誤消息。
復(fù)制代碼 代碼如下:
$messages = $validator->messages();
您也可以使用 failed 函數(shù)得到不帶錯誤消息的沒有通過驗證的規(guī)則的數(shù)組。
復(fù)制代碼 代碼如下:
$failed = $validator->failed();
文件驗證
Validator 類提供了一些驗證規(guī)則用于驗證文件，比如 size、mimes等。在驗證文件的時候，您可以和其他驗證一樣傳遞給驗證器。
附帶錯誤消息
在一個 Validator 實例上調(diào)用 messages 函數(shù)之后，將會得到一個 MessageBag 實例，該實例擁有很多處理錯誤消息的方便的函數(shù)。
獲取一個域的第一個錯誤消息
復(fù)制代碼 代碼如下:
echo $messages->first('email');
獲取一個域的全部錯誤消息
復(fù)制代碼 代碼如下:
foreach ($messages->get('email') as $message)
{
//
}
獲取全部域的全部錯誤消息
復(fù)制代碼 代碼如下:
foreach ($messages->all() as $message)
{
//
}
檢查一個域是否存在消息
復(fù)制代碼 代碼如下:
if ($messages->has('email'))
{
//
}
以某種格式獲取一條錯誤消息
復(fù)制代碼 代碼如下:
echo $messages->first('email', '<p>:message</p>');
注意: 默認(rèn)情況下，消息將使用與 Bootstrap 兼容的語法進(jìn)行格式化。
以某種格式獲取所有錯誤消息
復(fù)制代碼 代碼如下:
foreach ($messages->all('<li>:message</li>') as $message)
{
//
}
錯誤消息 & 視圖
一旦您執(zhí)行了驗證，您需要一種簡單的方法向視圖反饋錯誤消息。這在 Lavavel 中能夠方便的處理。以下面的路由作為例子：
復(fù)制代碼 代碼如下:
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)驗證失敗，我們使用 withErrors 函數(shù)把 Validator 實例傳遞給 Redirect。這個函數(shù)將刷新 Session 中保存的錯誤消息，使得在下次請求中能夠可用。
然而，注意我們沒有必要明確的在 GET 路由中綁定錯誤消息到路由。這是因為 Laravel 總會檢查 Session 中的錯誤，并自動綁定它們到視圖如果它們是可用的。所以，對于每個請求，一個 $errors 變量在所有視圖中總是可用的，允許您方便的認(rèn)為 $errors 總是被定義并可以安全使用的。$errors 變量將是一個 MessageBag 類的實例。
所以，在跳轉(zhuǎn)之后，您可以在視圖中使用自動綁定的 $errors 變量：
復(fù)制代碼 代碼如下:
<?php echo $errors->first('email'); ?>
可用的驗證規(guī)則
下面是一個所有可用的驗證規(guī)則的列表以及它們的功能：
復(fù)制代碼 代碼如下:
Accepted
Active URL
After (Date)
Alpha
Alpha Dash
Alpha Numeric
Before (Date)
Between
Confirmed
Date
Date Format
Different
E-Mail
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
驗證此規(guī)則的值必須是 yes、 on 或者是 1。這在驗證是否同意"服務(wù)條款"的時候非常有用。
active_url
驗證此規(guī)則的值必須是一個合法的 URL，根據(jù) php 函數(shù) checkdnsrr。
after:date
驗證此規(guī)則的值必須在給定日期之后，日期將通過 php 函數(shù) strtotime 傳遞。
alpha
驗證此規(guī)則的值必須全部由字母字符構(gòu)成。
alpha_dash
驗證此規(guī)則的值必須全部由字母、數(shù)字、中劃線或下劃線字符構(gòu)成。
alpha_num
驗證此規(guī)則的值必須全部由字母和數(shù)字構(gòu)成。
before:date
驗證此規(guī)則的值必須在給定日期之前，日期將通過 php 函數(shù) strtotime 傳遞。
between:min,max
驗證此規(guī)則的值必須在給定的 min 和 max 之間。字符串、數(shù)字以及文件都將使用大小規(guī)則進(jìn)行比較。
confirmed
驗證此規(guī)則的值必須和 foo_confirmation 的值相同。比如，需要驗證此規(guī)則的域是 password，那么在輸入中必須有一個與之相同的 password_confirmation 域。
date
驗證此規(guī)則的值必須是一個合法的日期，根據(jù) php 函數(shù) strtotime。
date_format:format
驗證此規(guī)則的值必須符合給定的 format 的格式，根據(jù) php 函數(shù) date_parse_from_format。
different:field
驗證此規(guī)則的值必須與指定的 field 域的值不同。
email
驗證此規(guī)則的值必須是一個合法的電子郵件地址。
exists:table,column
驗證此規(guī)則的值必須在指定的數(shù)據(jù)庫的表中存在。
Exists 規(guī)則的基礎(chǔ)使用
復(fù)制代碼 代碼如下:'state' => 'exists:states'
指定列名
復(fù)制代碼 代碼如下:
'state' => 'exists:states,abbreviation'
您也可以指定更多的條件，將以 "where" 的形式添加到查詢。
復(fù)制代碼 代碼如下:
'email' => 'exists:staff,email,account_id,1'
image
驗證此規(guī)則的值必須是一個圖片 (jpeg, png, bmp 或者 gif)。
in:foo,bar,...
驗證此規(guī)則的值必須在給定的列表中存在。
integer
驗證此規(guī)則的值必須是一個整數(shù)。
驗證此規(guī)則的值必須是一個合法的 IP 地址。
max:value
驗證此規(guī)則的值必須小于最大值 value。字符串、數(shù)字以及文件都將使用大小規(guī)則進(jìn)行比較。
mimes:foo,bar,...
驗證此規(guī)則的文件的 MIME 類型必須在給定的列表中。
MIME 規(guī)則的基礎(chǔ)使用
復(fù)制代碼 代碼如下:
'photo' => 'mimes:jpeg,bmp,png'
min:value
驗證此規(guī)則的值必須大于最小值 value。字符串、數(shù)字以及文件都將使用大小規(guī)則進(jìn)行比較。
not_in:foo,bar,...
驗證此規(guī)則的值必須在給定的列表中不存在。
numeric
驗證此規(guī)則的值必須是一個數(shù)字。
regex:pattern
驗證此規(guī)則的值必須符合給定的正則表達(dá)式。
注意: 當(dāng)使用 regex 模式的時候，有必要使用數(shù)組指定規(guī)則，而不是管道分隔符，特別是正則表達(dá)式中包含一個管道字符的時候。
required
驗證此規(guī)則的值必須在輸入數(shù)據(jù)中存在。
required_if:field,value
當(dāng)指定的域為某個值的時候，驗證此規(guī)則的值必須存在。
required_with:foo,bar,...
僅當(dāng)指定的域存在的時候，驗證此規(guī)則的值必須存在。
required_without:foo,bar,...
僅當(dāng)指定的域不存在的時候，驗證此規(guī)則的值必須存在。
same:field
驗證此規(guī)則的值必須與給定域的值相同。
size:value
驗證此規(guī)則的值的大小必須與給定的 value 相同。對于字符串，value 代表字符的個數(shù);對于數(shù)字，value 代表它的整數(shù)值，對于文件，value 代表文件以KB為單位的大小。
unique:table,column,except,idColumn
驗證此規(guī)則的值必須在給定的數(shù)據(jù)庫的表中唯一。如果 column 沒有被指定，將使用該域的名字。
Unique 規(guī)則的基礎(chǔ)使用
復(fù)制代碼 代碼如下:
'email' => 'unique:users'
指定列名
'email' => 'unique:users,email_address'
強制忽略一個給定的 ID
'email' => 'unique:users,email_address,10'
url
驗證此規(guī)則的值必須是一個合法的 URL。
定制錯誤消息
如果有需要，您可以使用定制的錯誤消息代替默認(rèn)的消息。這里有好幾種定制錯誤消息的方法。
傳遞定制消息到驗證器
復(fù)制代碼 代碼如下:
$messages = array(
'required' => 'The :attribute field is required.',
);
$validator = Validator::make($input, $rules, $messages);
注意: :attribute 占位符將被實際的進(jìn)行驗證的域的名字代替，您也可以在錯誤消息中使用其他占位符。
其他驗證占位符
復(fù)制代碼 代碼如下:
$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',
);
有些時候，您可能希望只對一個指定的域指定定制的錯誤消息：
對一個指定的域指定定制的錯誤消息
復(fù)制代碼 代碼如下:
$messages = array(
'email.required' => 'We need to know your e-mail address!',
);
在一些情況下，您可能希望在一個語言文件中指定錯誤消息而不是直接傳遞給 Validator。為了實現(xiàn)這個目的，請在 app/lang/xx/validation.php 文件中添加您的定制消息到 custom 數(shù)組。
在語言文件中指定錯誤消息
復(fù)制代碼 代碼如下:
'custom' => array(
'email' => array(
'required' => 'We need to know your e-mail address!',
),
),
定制驗證規(guī)則
Laravel 提供了一系列的有用的驗證規(guī)則;但是，您可能希望添加自己的驗證規(guī)則。其中一種方法是使用 Validator::extend 函數(shù)注冊定制的驗證規(guī)則：
注冊一個定制的驗證規(guī)則
復(fù)制代碼 代碼如下:
Validator::extend('foo', function($attribute, $value, $parameters)
{
return $value == 'foo';
});
注意: 傳遞給 extend 函數(shù)的規(guī)則的名字必須符合 "snake cased" 命名規(guī)則。
定制的驗證器接受三個參數(shù)：待驗證屬性的名字、待驗證屬性的值以及傳遞給這個規(guī)則的參數(shù)。
您也可以傳遞一個類的函數(shù)到 extend 函數(shù)，而不是使用閉包：
復(fù)制代碼 代碼如下:
Validator::extend('foo', 'FooValidator@validate');
注意您需要為您的定制規(guī)則定義錯誤消息。您既可以使用一個行內(nèi)的定制消息數(shù)組，也可以在驗證語言文件中進(jìn)行添加。
您也可以擴展 Validator 類本身，而不是使用閉包回調(diào)擴展驗證器。為了實現(xiàn)這個目的，添加一個繼承自 Illuminate/Validation/Validator 的驗證器類。您可以添加在類中添加以 validate 開頭的驗證函數(shù)：
擴展驗證器類
復(fù)制代碼 代碼如下:
<?php
class CustomValidator extends Illuminate/Validation/Validator {
public function validateFoo($attribute, $value, $parameters)
{
return $value == 'foo';
}
}
下面，您需要注冊定制的驗證器擴展：
您需要注冊定制的驗證器擴展
復(fù)制代碼 代碼如下:
Validator::resolver(function($translator, $data, $rules, $messages)
{
return new CustomValidator($translator, $data, $rules, $messages);
});
當(dāng)創(chuàng)建一個定制的驗證規(guī)則，您有時需要為錯誤消息定義一個定制的占位符。為了實現(xiàn)它，您可以像上面那樣創(chuàng)建一個定制的驗證器，并且在驗證器中添加一個 replaceXXX 函數(shù)：
復(fù)制代碼 代碼如下:
protected function replaceFoo($message, $attribute, $rule, $parameters)
{
return str_replace(':foo', $parameters[0], $message);
}
php技術(shù)：Laravel框架表單驗證詳解，轉(zhuǎn)載需保留來源！
鄭重聲明：本文版權(quán)歸原作者所有，轉(zhuǎn)載文章僅為傳播更多信息之目的，如作者信息標(biāo)記有誤，請第一時間聯(lián)系我們修改或刪除，多謝。
