> YII2中文手册 > Yii2.0中文开发向导9—验证器(Validator)

先看一下验证器的使用。

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)


下面会分几个部分单独的说一说每个验证器的功能、属性设置以及使用中注意的事项。