系統內置的驗證規則如下:
#### 1. 格式驗證類
require
驗證某個字段必須,例如:
'name'=>'require'
number 或者 integer
驗證某個字段的值是否為數字(采用filter_var驗證),例如:
'num'=>'number'
float
驗證某個字段的值是否為浮點數字(采用filter_var驗證),例如:
'num'=>'float'
boolean
驗證某個字段的值是否為布爾值(采用filter_var驗證),例如:
'num'=>'boolean'
email
驗證某個字段的值是否為email地址(采用filter_var驗證),例如:
'email'=>'email'
array
驗證某個字段的值是否為數組,例如:
'info'=>'array'
accepted
驗證某個字段是否為為 yes, on, 或是 1。這在確認"服務條款"是否同意時很有用,例如:
'accept'=>'accepted'
date
驗證值是否為有效的日期,例如:
'date'=>'date'
注:會對日期值進行strtotime后進行判斷。
alpha
驗證某個字段的值是否為字母,例如:
'name'=>'alpha'
alphaNum
驗證某個字段的值是否為字母和數字,例如:
'name'=>'alphaNum'
alphaDash
驗證某個字段的值是否為字母和數字,下劃線_及破折號-,例如:
'name'=>'alphaDash'
activeUrl
驗證某個字段的值是否為有效的域名或者IP,例如:
'host'=>'activeUrl'
url
驗證某個字段的值是否為有效的URL地址(采用filter_var驗證),例如:
'url'=>'url'
ip
驗證某個字段的值是否為有效的IP地址(采用filter_var驗證),例如:
'ip'=>'ip'
注:支持驗證ipv4和ipv6格式的IP地址。
dateFormat:format
驗證某個字段的值是否為指定格式的日期,例如:
'create_time'=>'dateFormat:y-m-d'
長度和區間驗證類
in
驗證某個字段的值是否在某個范圍,例如:
'num'=>'in:1,2,3'
notIn
驗證某個字段的值不在某個范圍,例如:
'num'=>'notIn:1,2,3'
between
驗證某個字段的值是否在某個區間,例如:
'num'=>'between:1,10'
notBetween
驗證某個字段的值不在某個范圍,例如:
'num'=>'notBetween:1,10'
length:num1,num2
驗證某個字段的值的長度是否在某個范圍,例如:
'name'=>'length:4,25'
或者指定長度
'name'=>'length:4'
如果驗證的數據是數組,則判斷數組的長度。
如果驗證的數據是File對象,則判斷文件的大小。
max:number
驗證某個字段的值的最大長度,例如:
'name'=>'max:25'
如果驗證的數據是數組,則判斷數組的長度。
如果驗證的數據是File對象,則判斷文件的大小。
min:number
驗證某個字段的值的最小長度,例如:
'name'=>'min:5'
如果驗證的數據是數組,則判斷數組的長度。
如果驗證的數據是File對象,則判斷文件的大小。
after:日期
驗證某個字段的值是否在某個日期之后,例如:
'begin_time' =>'after:2016-3-18',
before:日期
驗證某個字段的值是否在某個日期之前,例如:
'end_time' =>'before:2016-10-01',
expire:開始時間,結束時間
驗證當前操作(注意不是某個值)是否在某個有效日期之內,例如:
'expire_time' =>'expire:2016-2-1,2016-10-01',
allowIp:allow1,allow2,...
驗證當前請求的IP是否在某個范圍,例如:
'name' =>'allowIp:114.45.4.55',
注:該規則可以用于某個后臺的訪問權限
denyIp:allow1,allow2,...
驗證當前請求的IP是否禁止訪問,例如:
'name' =>'denyIp:114.45.4.55',
字段比較類
confirm
驗證某個字段是否和另外一個字段的值一致,例如:
'repassport'=>'require|confirm:passport'
different
驗證某個字段是否和另外一個字段的值不一致,例如:
'name'=>'require|different:account'
egt 或者 >=
驗證是否大于等于某個值,例如:
'score'=>'egt:60' ||
'num'=>'>=:100'
gt 或者 >
驗證是否大于某個值,例如:
'score'=>'gt:60' ||
'num'=>'>:100'
elt 或者 <=
驗證是否小于等于某個值,例如:
'score'=>'elt:100' ||
'num'=>'<=:100'
lt 或者 <
驗證是否小于某個值,例如:
'score'=>'lt:100'||
'num'=>'<:100'
eq 或者 = 或者 same
驗證是否等于某個值,例如:
'score'=>'eq:100'||
'num'=>'=:100'||
'num'=>'same:100'
filter驗證
支持使用filter_var進行驗證,例如:
'ip'=>'filter:validate_ip'
正則驗證
支持直接使用正則驗證,例如:
'zip'=>'\d{6}'
或者
'zip'=>'regex:\d{6}',
如果你的正則表達式中包含有|符號的話,必須使用數組方式定義。
'accepted'=>['regex'=>'/^(yes|on|1)$/i'],
也可以實現預定義正則表達式后直接調用,例如:
上傳驗證
file
驗證是否是一個上傳文件
image:width,height,type
驗證是否是一個圖像文件,width height和type都是可選,width和height必須同時定義。
fileExt:允許的文件后綴
驗證上傳文件后綴
fileMime:允許的文件類型
驗證上傳文件類型
fileSize:允許的文件字節大小
驗證上傳文件大小
行為驗證
使用行為驗證數據,例如:
'data'=>'behavior:\app\index\behavior\Check'
其它驗證
unique:table,field,except,pk
驗證當前請求的字段值是否為唯一的,例如:
// 表示驗證name字段的值是否在user表(不包含前綴)中唯一
'name' => 'unique:user',
// 驗證其他字段
'name' => 'unique:user,account',
// 排除某個主鍵值
'name' => 'unique:user,account,10',
// 指定某個主鍵值排除
'name' => 'unique:user,account,10,user_id',
如果需要對復雜的條件驗證唯一,可以使用下面的方式:
// 多個字段驗證唯一驗證條件
'name' => 'unique:user,status^account',
// 復雜驗證條件
'name' => 'unique:user,status=1&account='.$data['account'],
requireIf:field,value
驗證某個字段的值等于某個值的時候必須,例如:
// 當account的值等于1的時候 password必須
'password'=>'requireIf:account,1'
requireWith:field
驗證某個字段有值的時候必須,例如:
// 當account有值的時候password字段必須
'password'=>'requireWith:account'