验证器的使用代码样例如下:
<?php
namespace common\models;
use Yii;
use yii\base\Model;
/**
* Login form
*/
class LoginForm extends Model
{
public $username;
public $password;
public $rememberMe = true;
private $_user;
/**
* {@inheritdoc}
*/
public function rules()
{
return [
// username and password are both required
[['username', 'password'], 'required'],
// rememberMe must be a boolean value
['rememberMe', 'boolean'],
// password is validated by validatePassword()
['password', 'validatePassword'],
];
}
/**
* Validates the password.
* This method serves as the inline validation for password.
*
* @param string $attribute the attribute currently being validated
* @param array $params the additional name-value pairs given in the rule
*/
public function validatePassword($attribute, $params)
{
if (!$this->hasErrors()) {
$user = $this->getUser();
if (!$user || !$user->validatePassword($this->password)) {
$this->addError($attribute, 'Incorrect username or password.');
}
}
}
}
如上所示,验证器主要应用在rules里面,对当前model里面的属性值进行验证以反省是否满足某种要求。
验证器应用款式:书写形式为:[ 需要验证的属性,验证器名称,验证器参数 ]。
如果需要验证的属性为多个可用数组,如果为一个属性可用字符串也可用数组来表示。每个属性都可以有多个验证器,如上面的 password应用了 required和validatePassword两个验证器,validatePassword为自定义函数验证器。
常用验证器:
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)
文章评论