本文實例講述了Yii核心驗證器api。分享給大家參考，具體如下：
核心驗證器 Core Validators
前言
Yii 提供了一系列常用的核心 validators, 你可在
yiivalidators namespace 中找到. 不用使用長的驗證器類別名稱, 你可以使用別名代替他們.
例如, 你可以使用別名 required 來代替 yiivalidatorsRequiredValidator 類別:
<?php
public function rules()
{
return [
[['email', 'password'], 'required'],
];
}
?>
這個 yiivalidatorsValidator::$builtInValidators 屬性生命所有支援的驗證器的別名.
接下來, 我們將講解每種核心驗證器的用法.
1. boolean 對錯值
<?php [ // 检查是否 "selected" 是 0 或 1, 不管数据类型 ['selected', 'boolean'], // 检查是否 "deleted" 是一个 boolean 类型, 只能是 true 或则 false ['deleted', 'boolean', 'trueValue' => true, 'falseValue' => false, 'strict' => true], ] ?>
上面偵測是否是一個bool值.
trueValue: 代表true時的值. 預設為 '1'.
falseValue: 代表 false 時的值. 預設為 '0'.
strict: 是否輸入框中的值必須匹配 設定的 trueValue 和 falseValue. 預設為 false.
注意: 因為資料提交透過HTML形式都是字元創, 一般你需要設定 strict 屬性為 false.
2. captcha 驗證碼
<?php [ ['verificationCode', 'captcha'], ] ?>
這個驗證器通常和
yiicaptchaCaptchaAction 以及
yiicaptchaCaptcha 一起使用以確保輸入的是相同的驗證碼 透過 CAPTCHA 組件.
caseSensitive: 是否驗證碼需要區分大小寫. 預設為 false.
captchaAction: 預設的驗證碼的 CAPTCHA action 產生 CAPTCHA image的路徑. 預設為 'site/captcha'.
skipOnEmpty: 輸入為空的時候是否跳過驗證. 預設false, 即 input 輸入是必須的.
3. compare 比較
<?php [ // 验证是否 "password" 属性和 "password_repeat"是否相等 ['password', 'compare'], // 验证 age >= 30 ['age', 'compare', 'compareValue' => 30, 'operator' => '>='], ] ?>
這個驗證器比較指定的輸入值和另一個值確保他們之間使用指定的操作符.
compareAttribute: 屬性的名字即將會和誰比較.當驗證器被用來驗證一個屬性的時候, 他會和屬性名字相同但帶有後綴_repeat的屬性相比較. 例如, 如果要驗證的屬性名是password, 那麼預設比較的屬性名稱就是password_repeat 你可以指定你想要的值。
compareValue: 一個和輸入值比較的常數值. 當 property 和 compareAttribute 屬性被同時指定的時候, 這個值將優先.
operator: 比較的運算子. 預設是 ==, 即輸入值和 compareAttribute 或 compareValue 值相等的時候才會成功.
支援以下這些操作符號: ==、===、!=、!==、>、>=、<、<=。
4. date 日期
<?php [ [['from_date', 'to_date'], 'date'], ] ?>
這個驗證器檢查輸入的值是一個日期date, 時間time 或datetime 以一個合適的形式. 可選的,他能轉換輸入值成為一個UNIX時間戳存儲在一個通過timestampAttribute 指定的屬性裡.
format: 這個 date/time 是 http://php.net/manual/en/datetime.createfromformat.php 中聲明的所有支援的格式
如果這個值沒有設定, 他會自動取值 Yii::$app->formatter->dateFormat.
timestampAttribute: 屬性名稱用來儲存轉換將輸入的日期或時間. 也可以是相同的屬性名稱作為被驗證過的. 如果是這種情況, 原始的值將會被時間戳重寫. 你可以看看"如何處理日期選擇器DatePicker" 用範例.
http://www.yiiframework.com/doc-2.0/widget-jui#datepicker-date-input
如果輸入的是可選的，你也可能要添加一個預設值濾波器除了日期驗證，以確保空輸入儲存為NULL。否則你可能最終得到的日期像日期選擇器的輸入欄位在0000-00-00 或 您的資料庫1970-01-01.
<?php [ [['from_date', 'to_date'], 'default', 'value' => null], [['from_date', 'to_date'], 'date'], ], ?>
5.default 預設值
<?php
[
// 设置 "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
function foo($model, $attribute) {
// ... 组装 $value ...
return $value;
}
?>
6. double 浮點值
<?php [ // 检查 "salary" 是一个 double 数字 ['salary', 'double'], ] ?>
相當於一個數位驗證器：
max: 數字上限，沒設定不檢查
min: 數字下線，沒設定不檢查
7. email 信箱驗證
<?php [ // 检查邮箱是一个有效的 "email"地址 ['email', 'email'], ] ?>
allowName: 检查名字是否允许在邮箱中出现 (e.g. John Smith
checkDNS，是否检查电子邮件的域名是否存在，是否有任何一个A或MX记录。请注意，这可能检查由于临时DNS问题失败，即使电子邮件地址实际上是有效的。默认为false。
enableIDN，验证过程是否应考虑到IDN（国际化域名）。默认为false。需要注意的是，为了使用IDN验证您必须安装并启用国际PHP扩展，或异常将被抛出。
8. exist 是否存在
<?php [ // a1 需要在 属性列中存在 "a1" 这个好像默认就有啊 ['a1', 'exist'], // a1 存在,但它的值将使用A2来检查是否存在 ['a1', 'exist', 'targetAttribute' => 'a2'], // a1 和 a2 需要同时存在, 他们都将接收错误信息 [['a1', 'a2'], 'exist', 'targetAttribute' => ['a1', 'a2']], // a1 和 a2 需要同时存在, 只有 a1 将接收错误信息 ['a1', 'exist', 'targetAttribute' => ['a1', 'a2']], // a1 需要存在 通过检测a2 和 a3 (用 a1 的值) ['a1', 'exist', 'targetAttribute' => ['a2', 'a1' => 'a3']], // a1 需要存在. 如果 a1是一个数组, 那么每个元素都必须存在. ['a1', 'exist', 'allowArray' => true], ] ?>
这个验证器检查输入的值能否被找到在在对应的表的列值里，他只会在 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 文件验证
<?php [ // 检查 "primaryImage" 上传的文件格式是 PNG, JPG 或者 GIF // the file size must be less than 1MB ['primaryImage', 'file', 'extensions' => ['png', 'jpg', 'gif'], 'maxSize' => 1024*1024], ] ?>
检查是否是一个有效的上传文件。
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 一起使用. .
文件上传请参考：http://www.yiiframework.com/doc-2.0/guide-input-file-upload.html
10. filter 过滤
<?php
[
// 去掉 "username" 和 "email" 输入空格 跳过数组验证
[['username', 'email'], 'filter', 'filter' => 'trim', 'skipOnArray' => true],
// 验证正常 "phone" 输入
['phone', 'filter', 'filter' => function ($value) {
// 验证正确性手机代码
return $value;
}],
]
?>
这个验证器验证不了数据. 相反的, it applies a filter on the input value and assigns it back to the attribute being validated.
filter: 一个php回调函数定义一个filter. 他可能是一个全局函数的名字, 一个匿名函数等等. 函数的原型一定是<?php function ($value) { return $newValue; } ?>这个属性必须设置.
skipOnArray: 当输入只是一个数组的时候是否跳过.默认是 false. 请注意，如果过滤器无法处理数组输入，您应该将此属性设置为true。否则，可能会发生一些PHP错误.
小提示: 去空格直接用trim验证.
小提示: 部分封装可以直接使用系统函数如intval:
<?php ['property', 'filter', 'filter' => 'boolval'], ['property', 'filter', 'filter' => 'intval'], ?>
11. image 图片
<?php
[
// 检查 "primaryImage" 是否是一个有效的图片 且大小合适
['primaryImage', 'image', 'extensions' => 'png, jpg',
'minWidth' => 100, 'maxWidth' => 1000,
'minHeight' => 100, 'maxHeight' => 1000,
],
]
?>
文件验证器的扩展:
minWidth: 最小的宽度 不设无限制.
maxWidth: 最大的宽度 不设无限制.
minHeight: 最小的高度 不设无限制.
maxHeight: 最大的高度 不设无限制.
12. in 在那一个数组里面的值
<?php [ // 检查 "level" 是 1, 2 或 3 ['level', 'in', 'range' => [1, 2, 3]], ] ?>
检查输入的值是否存在于给定的系列值的列表中.
range: 给定范围值的列表.
strict: 输入值和给定值之间的比较结果是否应严格（的类型和值必须相同）。默认为false。
not: 验证结果是否应该被反转。默认为false。当此属性设置为true，验证检查，输入的值不能是给定列表的值中.
allowArray: 是否允许输入值是一个数组。如果这是真的，并输入值是一个数组，数组中的每个元素必须值的给定列表中找到，或验证会失败。
13. integer 整型验证
<?php [ // 检查 "age" 是一个整型值 ['age', 'integer'], ] ?>
max: 上限 不设不检查.
min: 下限 不设不检查..
14. match 正则匹配检查
<?php [ // 检查 "username" 以字母开头，并且只包含文字字符 ['username', 'match', 'pattern' => '/^[a-z]\w*$/i'] ] ?>
输入值指定的正则表达式匹配验证检查.
pattern: 输入值必须匹配的规则. 属性必须设置,否则将会抛出异常.
not: 是否反转验证结果. 默认 false.
15. number 数字检查
<?php [ // 检查 "salary" 是一个数字 ['salary', 'number'], ] ?>
相当于double验证器.
max: 上限 不设不检查.
min: 下限 不设不检查.
16. required 是否为空检查
<?php [ // 检查 "username" 和 "password" 不是空的 [['username', 'password'], 'required'], ] ?>
该验证器阻止用户提交空的表单数据.
requiredValue: 应该输入的值. 如果未设 意味着输入值 不应该为空.
strict: 验证一个值时是否应该检查数据类型. 默认false.当 requiredValue未设置时,如果这个属性是 true, 验证器会检查输入值不严格null;如果改属性false,验证器将使用一个松散的规则来确定一个值是空的或不. 当 requiredValue设置了,输入和requiredValue之间的比较也将检查数据类型，如果此属性为true。
17. safe 标记输入是安全属性
<?php [ // 标记 "description" 是一个 safe 的属性 ['description', 'safe'], ] ?>
这个验证器不会执行数据验证.相反, 它是用来标记的属性是一个安全属性(我猜作用是不会进行字符转义吧)。
18. string 字符串验证
<?php [ // 检查 "username"是一个 string 而且长度在 4 和 24 之间 ['username', 'string', 'length' => [4, 24]], ] ?>
这个验证器检查输入的值是一个字符串且长度在确定的值的范围里。
length: 指定待验证的字符串的长度. 可以指定以下形式:
一个整数: 字符串的精确长度;
单个数组元素: 输入的最小长度 (e.g. [8]). 必须超过或等于这个数
两个数组元素: 输入的最小长度和最大长度 (e.g. [8, 128]).
min: 输入字符串的最小长度 未设不限制.
max: 输入字符串的最大长度 未设不限制..
encoding: 输入字符串的编码 未设默认 UTF-8.
19. trim 去空格
<?php [ // 去掉 "username" 和 "email" 两边的空格 [['username', 'email'], 'trim'], ] ?>
不进行数据验证 只进行去空格 如果属性是一个数组 将会自动忽略此过滤.
20. unique 唯一性验证
<?php [ // a1 需要是在由“a1”属性表示的列中的唯一 ['a1', 'unique'], // a1 必须是唯一的，但列a2将用于检查的a1值的唯一性 ['a1', 'unique', 'targetAttribute' => 'a2'], // a1和a2的需要是唯一的，并且它们都将收到错误消息 [['a1', 'a2'], 'unique', 'targetAttribute' => ['a1', 'a2']], // a1和a2的需要是唯一的，只有a1将收到错误消息 ['a1', 'unique', 'targetAttribute' => ['a1', 'a2']], // a1需要通过检查的两个a2和a3的唯一性（使用a1的值）是唯一的 ['a1', 'unique', 'targetAttribute' => ['a2', 'a1' => 'a3']], ] ?>
这验证检查，如果输入的值是表列中的唯一。它仅适用于活动记录模型的属性。它支持验证对任何单个列或多个列。
targetClass: 应该是被用于验证查找输入值的活动记录类的名字。如果没有设置，将要使用的类目前正在验证该模型的.
targetAttribute: 应该用来验证输入值的唯一性在targetClass的属性的名称。如果没有设置，将使用目前正在验证的属性的名称。可以使用阵列来验证多列的唯一性的同时。数组的值是将被用于验证唯一性的属性，而数组键是其值要验证的属性。如果键和值都是一样的，你可以指定的值。
filter: a额外的过滤器被应用到用于检查输入值的唯一性的数据库查询。这可以是一个字符串或代表附加查询条件的数组(参考 yii\db\Query::where() 查询条件的格式), 或者是一个匿名函数像： function ($query), 其中$query是你可以在函数修改查询对象。
http://www.yiiframework.com/doc-2.0/yii-db-query.html#where()-detail
21. url 地址验证
<?php [ // 检查 "website" 是一个有效的 URL. 前置 "http://" 到 "website" 属性 // 如果它不具有一个URI模式 ['website', 'url', 'defaultScheme' => 'http'], ] ?>
validSchemes: 一个数组指定URI方案应被认为有效。默认为['HTTP'，'HTTPS']，意思是HTTP和HTTPS URL被认为是有效的。
defaultScheme: 默认URI方案要预先考虑到输入，如果它不具有方案的一部分。默认为null，意味着不修改输入值。
enableIDN：验证是否应考虑到IDN（国际化域名）。默认为false。需要注意的是，为了使用IDN验证您必须安装并启用国际PHP扩展，否则异常将会被抛出。
更多关于Yii相关内容感兴趣的读者可查看本站专题：《Yii框架入门及常用技巧总结》、《php优秀开发框架总结》、《smarty模板入门基础教程》、《php面向对象程序设计入门教程》、《php字符串(string)用法总结》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》
希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。
