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