本文实例讲述了Yii核心验证器api。分享给大家供大家参考，具体如下：

核心验证器 Core Validators

前言

Yii 提供了一系列常用的核心 validators,你可在 yii\validators namespace 中找到. 不用使用长的验证器类名,你可以使用别名代替他们.

例如,你可以使用别名 required 代替 yii\validators\requiredValidator 类:

这个 yii\validators\Validator::$builtInValidators 属性生命所有支持的验证器的别名.

接下来,我们将讲解每种核心验证器的用法.

1. boolean 对错值

上面检测是否是一个bool值.

trueValue: 代表true时的值. 默认为 '1'. falseValue: 代表 false 时的值. 默认为 '0'. strict: 是否输入框中的值必须匹配 设置的 trueValue 和 falseValue. 默认为 false.

注意: 因为数据提交通过HTML形式都是字符创,一般你需要设置 strict 属性为 false.

2. captcha 验证码

这个验证器通常和 yii\captcha\CaptchaAction 以及 yii\captcha\Captcha 一起使用以确保输入的是相同的验证码 通过 CAPTCHA 组件. caseSensitive: 是否验证码需要区分大小写. 默认为 false. captchaAction: 默认的验证码的 CAPTCHA action 生成 CAPTCHA image的路径. 默认为 'site/captcha'. skipOnEmpty: 输入为空的时候是否跳过验证. 默认false,即 input 输入是必须的.

3. compare 比较

这个验证器比较指定的输入值和另一个值确保他们之间使用指定的操作符.

compareAttribute: 属性的名字即将会和谁比较.当验证器被用来验证一个属性的时候,他会和属性名字相同 但带有后缀 _repeat的属性相比较. 例如,如果要验证的属性名是 password,那么默认对比的属性名就是 password_repeat 你可以指定你想要的值. compareValue: 一个和输入值比较的常量值. 当 property 和 compareAttribute 属性被同时指定的时候,这个值将优先. operator: 比较的操作符. 默认是 ==,即输入值和 compareAttribute 或 compareValue 值相等的时候才会成功. 支持下面这些操作符: ==、===、!=、!==、>、>=、<、<=。

4. date 日期

这个验证器检查输入的值是一个日期date,时间time 或者datetime 以一个合适的形式. 可选的,他能转换输入值成为一个UNIX时间戳存储在一个通过timestampAttribute 指定的属性里.

format: 这个 date/time 是 中声明的所有支持的格式

如果这个值没有设置,他会自动取值 Yii::$app->formatter->dateFormat. timestampAttribute: 属性名用来存储转换将输入的日期或时间. 也可以是相同的属性名作为被验证过的. 如果是这种情况,原始的值将会被时间戳重写. 你可以看看 "如何处理日期选择器 DatePicker" 用例子.

如果输入的是可选的，你也可能要添加一个默认值滤波器除了日期验证，以确保空输入存储为NULL。否则你可能最终得到的日期像日期选择器的输入字段在0000-00-00 或 您的数据库1970-01-01.

5.default 默认值

这个验证器不验证数据. 当他们为空的时候.分配给属性值。

value: 表单的默认值 函数原型如下,

6. double 浮点值

相当于一个数字验证器：

max: 数字上限，没设置不检查 min: 数字下线，没设置不检查

7. email 邮箱验证

allowName: 检查名字是否允许在邮箱中出现 (e.g. John Smith ). 默认为 false. checkDNS，是否检查电子邮件的域名是否存在，是否有任何一个A或MX记录。请注意，这可能检查由于临时DNS问题失败，即使电子邮件地址实际上是有效的。默认为false。 enableIDN，验证过程是否应考虑到IDN（国际化域名）。默认为false。需要注意的是，为了使用IDN验证您必须安装并启用国际PHP扩展，或异常将被抛出。

8. exist 是否存在

这个验证器检查输入的值能否被找到在在对应的表的列值里，他只会在 Active Record model 模型的属性里起作用.

他支持验证单列或多列

targetClass: 用来寻找输入值验证的 Active Record 类名. 如果未设置,默认使用当前设置的模型类. targetAttribute: 应该用于验证输入值的存在在targetClass的属性的名称。如果没有设置，将使用目前正在验证的属性的名称。可以使用阵列来验证多列的存在的同时。数组的值是将被用于验证存在的属性，而数组键是其值要验证的属性。如果键和值都是一样的，你可以指定值. filter: additional filter to be applied to the DB query used to check the existence of the input value. This can be a string or an array representing the additional query condition (refer to yii\db\Query::where() on the format of query condition),or an anonymous function with the signature function ($query),where $query is the Query object that you can modify in the function. allowArray: 是否允许输入的值是一个array.默认 false. 若果属性是 true 而且输入是一个 array,那么熟这里的每一个元素都必须存在在指向的目标列里. 注意这个属性不能被设置成true 如果你设置验证多列通过设置 targetAttribute 为一个 array.

9. file 文件验证

检查是否是一个有效的上传文件。

extensions: 允许上传的文件类型列表.他可以是一个数组 或者是一个以逗号分割的字符串(如. "gif,jpg"). 扩展名不区分大小写，默认为 null,意味着所有的文件扩展名是允许的. mimeTypes: 允许上传的文件资源的媒体类型。他可以是一个数组 或者是一个以逗号或空格分割的字符串 (如. "image/jpeg,image/png"). 不区分大小写，默认为 null,意味着所有的文件扩展名是允许的. minSize: 上传文件的最小字节数 未设不做判断. maxSize: 上传文件的最大字节数 未设不做判断. maxFiles: 最大的上传文件数 默认为 1,意味着只能上传单个文件对于单个文件上传框. 如果大于 1,那么 input必须是一个 array 包含至多 maxFiles 数量的上传文件. checkExtensionByMimeType: 是否检查文件的扩展名. 如果由MIME类型检查所产生的扩展不同于上传的文件扩展名，该文件将被认为是无效的。默认值为true，意思进行这样的检查。 FileValidator 和 yii\web\UploadedFile 一起使用. .

文件上传请参考：

targetClass: 应该是被用于验证查找输入值的活动记录类的名字。如果没有设置，将要使用的类目前正在验证该模型的. targetAttribute: 应该用来验证输入值的唯一性在targetClass的属性的名称。如果没有设置，将使用目前正在验证的属性的名称。可以使用阵列来验证多列的唯一性的同时。数组的值是将被用于验证唯一性的属性，而数组键是其值要验证的属性。如果键和值都是一样的，你可以指定的值。 filter: a额外的过滤器被应用到用于检查输入值的唯一性的数据库查询。这可以是一个字符串或代表附加查询条件的数组(参考 yii\db\Query::where() 查询条件的格式),或者是一个匿名函数像： function ($query),其中$query是你可以在函数修改查询对象。

validSchemes: 一个数组指定URI方案应被认为有效。默认为['HTTP'，'HTTPS']，意思是HTTP和HTTPS URL被认为是有效的。 defaultScheme: 默认URI方案要预先考虑到输入，如果它不具有方案的一部分。默认为null，意味着不修改输入值。 enableIDN：验证是否应考虑到IDN（国际化域名）。默认为false。需要注意的是，为了使用IDN验证您必须安装并启用国际PHP扩展，否则异常将会被抛出。

更多关于Yii相关内容感兴趣的读者可查看本站专题：《》、《》、《》、《》、《》、《》及《PHP常见数据库操作技巧汇总》

希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。