先看一下验证器的使用。
public function rules() { return [ [['email', 'password'], 'required'], ['password', 'string', 'min'=>6], ]; }
如上所示,验证器主要使用在rules里面,对当前model里面的属性值进行验证以检查是否满足某种要求。
验证器使用格式
书写格式为:[需要验证的属性,验证器名称,验证器参数]。
如果需要验证的属性为多个可用数组,如果为一个属性可用字符串也可用数组来表示。
每个属性都可以有多个验证器,如上面的password使用了 required和string两个验证器。
常用验证器
Yii2已经内置了一些常用的验证器。所有的验证器都从基类yii\validators\Validator继承实现。我大概总结下有这么几类。
数字相关
-
integer——整数
用来检测属性值是否为整数,以及最大、最小值检测等。(yii\validators\NumberValidator) -
double——浮点
用来检测属性值是否为浮点数,即小数。(yii\validators\NumberValidator) -
number——数字
这个和上面的double完全相同,只是用了2个名称。(yii\validators\NumberValidator)
格式相关
-
date——日期
检验属性值是否为正确的日期格式。(yii\validators\DateValidator) -
email——邮件
检测属性值是否是正确的电子邮件格式。(yii\validators\EmailValidator) -
url——URL
用来判断属性值是否是正确的url地址。(yii\validators\UrlValidator)
对值进行函数处理
-
filter——过滤器
这个是对属性值进行加工处理的。如对属性值加前缀、替换特定的字符串等等。(yii\validators\FilterValidator) -
trim——裁边
这个是对属性值进行加工处理的。只是去掉字符串两侧的空格、或指定的字符串。(yii\validators\FilterValidator)
上传文件验证
-
file——文件
这个主要是对上传的文件进行验证,如格式、大小等。(yii\validators\FileValidator) -
image——图片
这个和上面的file验证器差不多,不过是专门用来验证图片的。(yii\validators\ImageValidator)
判断比较
-
compare——比较
用来对两个属性值进行比较,如相等、大于、小于比较等。(yii\validators\CompareValidator) -
in——包含(范围)
用来检测属性值是否包含在指定的数组中。(yii\validators\RangeValidator) -
exist——存在
用来检测在数据表中是否已经存在此属性值。(yii\validators\ExistValidator) -
unique——唯一性
这个和exist差不多,用来检测值是否是唯一。(yii\validators\UniqueValidator) -
string——字符串
对属性值进行长度判断,如最大长度、最短长度等。(yii\validators\StringValidator) -
boolean——布尔型
用来检查属性的值是否为布尔值。(yii\validators\BooleanValidator) -
default——默认值
这个是用来给属性设置默认值的。如当属性值为null的时候,给它设置为 空的默认值。(yii\validators\DefaultValueValidator) -
required——必填
这个用来检查属性值是否为空。(yii\validators\RequiredValidator) -
captcha——验证码
这个主要是在界面使用验证码的时候对验证码进行验证的。(yii\captcha\CaptchaValidator) -
match——正则表达式
这个就比较强大了,用来检测属性值是否匹配给出的正则。上面所列出的基本都可以用这个实现。(yii\validators\RegularExpressionValidator)
其它
-
safe——安全
这个不进行验证,仅仅用来指定属性值是安全的。(yii\validators\SafeValidator)
下面会分几个部分单独的说一说每个验证器的功能、属性设置以及使用中注意的事项。