官方文档 - 内置规则
系统内置的验证规则如下:
格式验证类:
规则 | 说明 | 示例 |
---|---|---|
require | 验证某个字段必须 | ‘name’=>’require’ |
number 或者 integer | 验证某个字段的值是否为数字(采用filter_var验证) | ‘num’=>’number’ |
float | 验证某个字段的值是否为浮点数字(采用filter_var验证) | ‘num’=>’float’ |
boolean | 验证某个字段的值是否为布尔值(采用filter_var验证) | ‘num’=>’boolean’ |
验证某个字段的值是否为email地址(采用filter_var验证) | ‘email’=>’email’ | |
array | 验证某个字段的值是否为数组 | ‘info’=>’array’ |
accepted | 验证某个字段是否为为 yes, on, 或是 1。这在确认”服务条款”是否同意时很有用 | ‘accept’=>’accepted’ |
date | 验证值是否为有效的日期,会对日期值进行strtotime后进行判断 | ‘date’=>’date’ |
alpha | 验证某个字段的值是否为字母 | ‘name’=>’alpha’ |
alphaNum | 验证某个字段的值是否为字母和数字 | ‘name’=>’alphaNum’ |
alphaDash | 验证某个字段的值是否为字母和数字,下划线_及破折号- | ‘name’=>’alphaDash’ |
activeUrl | 验证某个字段的值是否为有效的域名或者IP | ‘host’=>’activeUrl’ |
url | 验证某个字段的值是否为有效的URL地址(采用filter_var验证) | ‘url’=>’url’ |
ip | 验证某个字段的值是否为有效的IP地址(采用filter_var验证),支持验证ipv4和ipv6格式的IP地址 | ‘ip’=>’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 | 验证某个字段的值的长度是否在某个范围,或者指定长度。 *如果验证的数据是数组,则判断数组的长度。 如果验证的数据是File对象,则判断文件的大小。 | ‘name’=>’length:4,25’ ’name’=>’length:4’ |
max:number | 验证某个字段的值的最大长度 *如果验证的数据是数组,则判断数组的长度。 如果验证的数据是File对象,则判断文件的大小。 | ‘name’=>’max:25’ |
min:number | 验证某个字段的值的最小长度 *如果验证的数据是数组,则判断数组的长度。 如果验证的数据是File对象,则判断文件的大小。 | ‘name’=>’min:5’ |
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 |
different | 验证某个字段是否和另外一个字段的值不一致 | ‘name’=>’require |
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}’, |
上传验证:
规则 | 说明 | 示例 |
---|---|---|
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’ |