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