核心验证器（Core Validators）

由  创建， 最后一次修改 2016-02-24 核心验证器（Core Validators）Yii 提供一系列常用的核心验证器，主要存在于?yii\validators?命名空间之下。为了避免使用冗长的类名，你可以直接用昵称来指定相应的核心验证器。比如你可以用?required?昵称代指 yii\validators\RequiredValidator 类：public function rules(){ return [ [['email', 'password'], 'required'], ];}yii\validators\Validator::builtInValidators 属性声明了所有被支持的验证器昵称。下面，我们将详细介绍每一款验证器的主要用法和属性。yii\validators\BooleanValidator[ // 检查 "selected" 是否为 0 或 1，无视数据类型 ['selected', 'boolean'], // 检查 "deleted" 是否为布尔类型，即 true 或 false ['deleted', 'boolean', 'trueValue' => true, 'falseValue' => false, 'strict' => true],]该验证器检查输入值是否为一个布尔值。trueValue： 代表真的值。默认为?'1'。falseValue：代表假的值。默认为?'0'。strict：是否要求待测输入必须严格匹配?trueValue?或?falseValue。默认为?false。注意：因为通过 HTML 表单传递的输入数据都是字符串类型，所以一般情况下你都需要保持 yii\validators\BooleanValidator::strict 属性为假。yii\captcha\CaptchaValidator[ ['verificationCode', 'captcha'],]该验证器通常配合 yii\captcha\CaptchaAction 以及 yii\captcha\Captcha 使用，以确保某一输入与 yii\captcha\Captcha 小部件所显示的验证代码（verification code）相同。caseSensitive：对验证代码的比对是否要求大小写敏感。默认为 false。captchaAction：指向用于渲染 CAPTCHA 图片的 yii\captcha\CaptchaAction 的?路由。默认为?'site/captcha'。skipOnEmpty：当输入为空时，是否跳过验证。默认为 false，也就是输入值为必需项。yii\validators\CompareValidator[ // 检查 "password" 特性的值是否与 "password_repeat" 的值相同 ['password', 'compare'], // 检查年龄是否大于等于 30 ['age', 'compare', 'compareValue' => 30, 'operator' => '>='],]该验证器比较两个特定输入值之间的关系是否与?operator?属性所指定的相同。compareAttribute：用于与原特性相比较的特性名称。当该验证器被用于验证某目标特性时，该属性会默认为目标属性加后缀_repeat。举例来说，若目标特性为?password，则该属性默认为?password_repeat。compareValue：用于与输入值相比较的常量值。当该属性与?compareAttribute?属性同时被指定时，该属性优先被使用。operator：比较操作符。默认为?==，意味着检查输入值是否与?compareAttribute?或?compareValue?的值相等。该属性支持如下操作符：==：检查两值是否相等。比对为非严格模式。===：检查两值是否全等。比对为严格模式。!=：检查两值是否不等。比对为非严格模式。!==：检查两值是否不全等。比对为严格模式。>：检查待测目标值是否大于给定被测值。>=：检查待测目标值是否大于等于给定被测值。<：检查待测目标值是否小于给定被测值。<=：检查待测目标值是否小于等于给定被测值。yii\validators\DateValidator[ [['from', 'to'], 'date'],]该验证器检查输入值是否为适当格式的 date，time，或者 datetime。另外，它还可以帮你把输入值转换为一个 UNIX 时间戳并保存到 yii\validators\DateValidator::timestampAttribute 属性所指定的特性里。format：待测的 日期/时间 格式。请参考?date_create_from_format() 相关的 PHP 手册了解设定格式字符串的更多细节。默认值为'Y-m-d'。timestampAttribute：用于保存用输入时间/日期转换出来的 UNIX 时间戳的特性。yii\validators\DefaultValueValidator[ // 若 "age" 为空，则将其设为 null ['age', 'default', 'value' => null], // 若 "country" 为空，则将其设为 "USA" ['country', 'default', 'value' => 'USA'], // 若 "from" 和 "to" 为空，则分别给他们分配自今天起，3 天后和 6 天后的日期。 [['from', 'to'], 'default', 'value' => function ($model, $attribute) { return date('Y-m-d', strtotime($attribute === 'to' ? '+3 days' ：'+6 days')); }],]该验证器并不进行数据验证。而是，给为空的待测特性分配默认值。value：默认值，或一个返回默认值的 PHP Callable 对象（即回调函数）。它们会分配给检测为空的待测特性。PHP 回调方法的样式如下：function foo($model, $attribute) { // ... 计算 $value ... return $value;}补充：如何判断待测值是否为空，被写在另外一个话题的处理空输入章节。yii\validators\NumberValidator[ // 检查 "salary" 是否为浮点数 ['salary', 'double'],]该验证器检查输入值是否为双精度浮点数。他等效于?number?验证器。max：上限值（含界点）。若不设置，则验证器不检查上限。min：下限值（含界点）。若不设置，则验证器不检查下限。yii\validators\EmailValidator[ // 检查 "email" 是否为有效的邮箱地址 ['email', 'email'],]该验证器检查输入值是否为有效的邮箱地址。allowName：检查是否允许带名称的电子邮件地址 (e.g.?张三 <John.san@example.com>)。 默认为 false。checkDNS：检查邮箱域名是否存在，且有没有对应的 A 或 MX 记录。不过要知道，有的时候该项检查可能会因为临时性 DNS 故障而失败，哪怕它其实是有效的。默认为 false。enableIDN：验证过程是否应该考虑 IDN（internationalized domain names，国际化域名，也称多语种域名，比如中文域名）。默认为 false。要注意但是为使用 IDN 验证功能，请先确保安装并开启?intl?PHP 扩展，不然会导致抛出异常。yii\validators\ExistValidator[ // a1 需要在 "a1" 特性所代表的字段内存在 ['a1', 'exist'], // a1 必需存在，但检验的是 a1 的值在字段 a2 中的存在性 ['a1', 'exist', 'targetAttribute' => 'a2'], // a1 和 a2 的值都需要存在，且它们都能收到错误提示 [['a1', 'a2'], 'exist', 'targetAttribute' => ['a1', 'a2']], // a1 和 a2 的值都需要存在，只有