accepted
驗(yàn)證的字段必須為
yes、on、1、或true。這在確認(rèn)服務(wù)條款是否同意時(shí)相當(dāng)有用。
active_url
相當(dāng)于使用了 PHP 函數(shù)
dns_get_record,驗(yàn)證的字段必須具有有效的A或AAAA記錄。
after:date
驗(yàn)證的字段必須是給定日期后的值。這個日期將會通過
PHP函數(shù)strtotime來驗(yàn)證。
'start_date' => 'required|date|after:tomorrow'
- 你也可以指定其它的字段來比較日期:
'finish_date' => 'required|date|after:start_date'
after_or_equal:date
驗(yàn)證的字段必須等于給定日期之后的值。更多信息請參見
after規(guī)則。
alpha
驗(yàn)證的字段必須完全是字母的字符。
alpha_dash
驗(yàn)證的字段可能具有
字母、數(shù)字、破折號-以及下劃線_。
alpha_num
驗(yàn)證的字段必須完全是字母、數(shù)字。
array
驗(yàn)證的字段必須是一個
PHP數(shù)組。
before:date
驗(yàn)證的字段必須是給定日期之前的值。這個日期將會通過
PHP函數(shù)strtotime來驗(yàn)證。
before_or_equal:date
驗(yàn)證的字段必須是給定日期之前或之前的值。這個日期將會使用
PHP函數(shù)strtotime來驗(yàn)證。
between:min,max
驗(yàn)證的字段的大小必須在給定的
min和max之間。字符串、數(shù)字、數(shù)組或是文件大小的計(jì)算方式都用size方法進(jìn)行評估。
boolean
驗(yàn)證的字段必須能夠被轉(zhuǎn)換為布爾值??山邮艿膮?shù)為
true、false、1、0、"1"以及"0"。
confirmed
驗(yàn)證的字段必須和
foo_confirmation的字段值一致。例如,如果要驗(yàn)證的字段是password,輸入中必須存在匹配的password_confirmation字段。
date
驗(yàn)證的字段值必須是通過
PHP函數(shù)strtotime校驗(yàn)的有效日期。
date_equals:date
驗(yàn)證的字段必須等于給定的日期。該日期會被傳遞到
PHP函數(shù)strtotime。
date_format:format
驗(yàn)證的字段必須與給定的格式相匹配。你應(yīng)該只使用
date或date_format其中一個用于驗(yàn)證,而不應(yīng)該同時(shí)使用兩者。
different:field
驗(yàn)證的字段值必須與字段
field的值不同。
digits:value
驗(yàn)證的字段必須是數(shù)字,并且必須具有確切的值。
digits_between:min,max
驗(yàn)證的字段的長度必須在給定的
min和max之間。
dimensions
驗(yàn)證的文件必須是圖片并且圖片比例必須符合規(guī)則:
'avatar' => 'dimensions:min_width=100,min_height=200'
- 可用的規(guī)則為:
min_width、max_width、min_height、max_height、width、height、ratio。
- 比例應(yīng)該使用寬度除以高度的方式來約束。這樣可以通過
3/2這樣的語句或像1.5這樣的浮點(diǎn)的約束:
'avatar' => 'dimensions:ratio=3/2'
- 由于此規(guī)則需要多個參數(shù),因此你可以
Rule::dimensions方法來構(gòu)造可讀性高的規(guī)則:
use Illuminate\Validation\Rule;
Validator::make($data, [
'avatar' => [
'required',
Rule::dimensions()->maxWidth(1000)->maxHeight(500)->ratio(3 / 2),
],
]);
distinct
驗(yàn)證數(shù)組時(shí),指定的字段不能有任何重復(fù)值。
'foo.*.id' => 'distinct'
驗(yàn)證的字段必須符合
exists:table,column
驗(yàn)證的字段必須存在于給定的數(shù)據(jù)庫表中。
- Exists 規(guī)則的基本使用方法
'state' => 'exists:states'
- 指定自定義字段名稱
'state' => 'exists:states,abbreviation'
- 如果你需要指定
exists方法用來查詢的數(shù)據(jù)庫。你可以通過使用點(diǎn)語法將數(shù)據(jù)庫的名稱添加到數(shù)據(jù)表前面來實(shí)現(xiàn)這個目的:
'email' => 'exists:connection.staff,email'
- 如果要自定義驗(yàn)證規(guī)則執(zhí)行的查詢,可以使用
Rule類來定義規(guī)則。在這個例子中,我們使用數(shù)組指定驗(yàn)證規(guī)則,而不是使用|字符來分隔它們:
use Illuminate\Validation\Rule;
Validator::make($data, [
'email' => [
'required',
Rule::exists('staff')->where(function ($query) {
$query->where('account_id', 1);
}),
],
]);
file
驗(yàn)證的字段必須是成功上傳的文件。
filled
驗(yàn)證的字段在存在時(shí)不能為空。
image
驗(yàn)證的文件必須是一個圖像
jpeg、png、bmp、gif、或svg。
in:foo,bar,...
驗(yàn)證的字段必須包含在給定的值列表中。因?yàn)檫@個規(guī)則通常需要你
implode一個數(shù)組,Rule::in方法可以用來構(gòu)造規(guī)則:
use Illuminate\Validation\Rule;
Validator::make($data, [
'zones' => [
'required',
Rule::in(['first-zone', 'second-zone']),
],
]);
in_array:anotherfield
驗(yàn)證的字段必須存在于另一個字段
anotherfield的值中。
integer
驗(yàn)證的字段必須是整數(shù)。
ip
驗(yàn)證的字段必須是
IP地址。
ipv4
驗(yàn)證的字段必須是
IPv4地址。
ipv6
驗(yàn)證的字段必須是
IPv6地址。
json
驗(yàn)證的字段必須是有效的
JSON字符串。
max:value
驗(yàn)證中的字段必須小于或等于
value。字符串、數(shù)字、數(shù)組或是文件大小的計(jì)算方式都用size方法進(jìn)行評估。
mimetypes:text/plain,...
驗(yàn)證的文件必須與給定
MIME類型之一匹配:
'video' => 'mimetypes:video/avi,video/mpeg,video/quicktime'
- 要確定上傳文件的
MIME類型,會讀取文件的內(nèi)容來判斷MIME類型,這可能與客戶端提供的MIME類型不同。
mimes:foo,bar,...
驗(yàn)證的文件必須具有與列出的其中一個擴(kuò)展名相對應(yīng)的
MIME類型。
- MIME 規(guī)則基本用法
'photo' => 'mimes:jpeg,bmp,png'
即使你可能只需要驗(yàn)證指定擴(kuò)展名,但此規(guī)則實(shí)際上會驗(yàn)證文件的
MIME類型,其通過讀取文件的內(nèi)容以猜測它的MIME類型。這個過程看起來只需要你指定擴(kuò)展名,但實(shí)際上該規(guī)則是通過讀取文件的內(nèi)容并判斷其
MIME的類型來驗(yàn)證的。可以在鏈接中找到完整的
MIME類型列表及其相應(yīng)的擴(kuò)展名:
min:value
驗(yàn)證中的字段必須具有最小值。字符串、數(shù)字、數(shù)組或是文件大小的計(jì)算方式都用
size方法進(jìn)行評估。
nullable
驗(yàn)證的字段可以為
null。這在驗(yàn)證基本數(shù)據(jù)類型時(shí)特別有用,例如可以包含空值的字符串和整數(shù)。
not_in:foo,bar,...
驗(yàn)證的字段不能包含在給定的值列表中。
Rule::notIn方法可以用來構(gòu)建規(guī)則:
Validator::make($data, [
'toppings' => [
'required',
Rule::notIn(['sprinkles', 'cherries']),
],
]);
numeric
驗(yàn)證的字段必須是數(shù)字。
present
驗(yàn)證的字段必須存在于輸入數(shù)據(jù)中,但可以為空。
regex:pattern
驗(yàn)證的字段必須與給定的正則表達(dá)式匹配。
- 注意: 當(dāng)使用
regex規(guī)則時(shí),你必須使用數(shù)組,而不是使用|分隔符,特別是如果正則表達(dá)式包含|字符。
required
驗(yàn)證的字段必須存在于輸入數(shù)據(jù)中,而不是空。如果滿足以下條件之一,則字段被視為
空:
- 該值為
null. - 該值為空字符串。
- 該值為空數(shù)組或空的 可數(shù) 對象。
- 該值為沒有路徑的上傳文件。
required_if:anotherfield,value,...
如果指定的其它字段
anotherfield等于任何一個value時(shí),被驗(yàn)證的字段必須存在且不為空。
required_unless:anotherfield,value,...
如果指定的其它字段
anotherfield等于任何一個value時(shí),被驗(yàn)證的字段不必存在。
required_with:foo,bar,...
只要在指定的其他字段中有任意一個字段存在時(shí),被驗(yàn)證的字段就必須存在并且不能為空。
required_with_all:foo,bar,...
只有當(dāng)所有的其他指定字段全部存在時(shí),被驗(yàn)證的字段才必須存在并且不能為空。
required_without:foo,bar,...
只要在其他指定的字段中有任意一個字段不存在,被驗(yàn)證的字段就必須存在且不為空。
required_without_all:foo,bar,...
只有當(dāng)所有的其他指定的字段都不存在時(shí),被驗(yàn)證的字段才必須存在且不為空。
same:field
給定字段必須與驗(yàn)證的字段匹配。
size:value
驗(yàn)證的字段必須具有與給定值匹配的大小。對于字符串來說,
value對應(yīng)于字符數(shù)。對于數(shù)字來說,value對應(yīng)于給定的整數(shù)值。對于數(shù)組來說,size對應(yīng)的是數(shù)組的count值。對文件來說,size對應(yīng)的是文件大?。▎挝?kb)。
string
驗(yàn)證的字段必須是字符串。如果要允許該字段的值為
null,就將nullable規(guī)則附加到該字段中。
timezone
驗(yàn)證的字段必須是有效的時(shí)區(qū)標(biāo)識符,會根據(jù)
PHP函數(shù)timezone_identifiers_list來判斷。
unique:table,column,except,idColumn
驗(yàn)證的字段在給定的數(shù)據(jù)庫表中必須是唯一的。如果沒有指定
column,將會使用字段本身的名稱。
- 指定自定義字段名稱:
'email' => 'unique:users,email_address'
自定義數(shù)據(jù)庫連接
有時(shí),你可能需要為驗(yàn)證程序創(chuàng)建的數(shù)據(jù)庫查詢設(shè)置自定義連接。上面的例子中,將
unique:users設(shè)置為驗(yàn)證規(guī)則,等于使用默認(rèn)數(shù)據(jù)庫連接來查詢數(shù)據(jù)庫。如果要對其進(jìn)行修改,請使用點(diǎn)語法指定連接和表名:
'email' => 'unique:connection.users,email_address'
強(qiáng)迫
Unique規(guī)則忽略指定ID:如果你想在進(jìn)行字段唯一性驗(yàn)證時(shí)忽略指定
ID。例如,在更新個人資料頁面會包含用戶名、郵箱和地點(diǎn)。這時(shí)你會想要驗(yàn)證更新的E-mail值是否唯一。如果用戶僅更改了用戶名字段而沒有改E-mail字段,就不需要拋出驗(yàn)證錯誤,因?yàn)榇擞脩粢呀?jīng)是這個E-mail的擁有者了。使用
Rule類定義規(guī)則來指示驗(yàn)證器忽略用戶的ID。 這個例子中通過數(shù)組來指定驗(yàn)證規(guī)則,而不是使用|字符來分隔:
Validator::make($data, [
'email' => [
'required',
Rule::unique('users')->ignore($user->id),
],
]);
- 如果你的數(shù)據(jù)表使用的主鍵名稱不是
id,那就在調(diào)用ignore方法時(shí)指定字段的名稱:
'email' => Rule::unique('users')->ignore($user->id, 'user_id')
增加額外的
Where語句:你也可以通過
where方法指定額外的查詢條件。例如,我們添加account_id為1的約束:
'email' => Rule::unique('users')->where(function ($query) {
$query->where('account_id', 1);
})
url
驗(yàn)證的字段必須是有效的
URL。