先看一下验证器的使用。
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)
下面会分几个部分单独的说一说每个验证器的功能、属性设置以及使用中注意的事项。