YII的models中的rules部分是一些表单的验证规则，对于表单验证十分有用，在相应的视图（views）里面添加了表单，在表单被提交之前程序都会自动先来这里面的规则里验证，只有通过对其有效的限制规则后才能被提交，可以很有效地保证表单安全和信息的有效性。还是给大家具体说明一下：

以下是视图（views）部分的简单代码：

1. <?php $form=$this->beginWidget('CActiveForm', array(  
2.   'id'=>'tag-form',  
3.   'enableAjaxValidation'=>false,  
4. )); ?>  
5.   <div class="row">  
6.     <?php echo $form->labelEx($model,'tagname'); ?>  
7.     <?php echo $form->textField($model,'tagname',array('size'=>20,'maxlength'=>32)); ?>  
8.   </div>  
9.   <div class="row">  
10.     <?php echo $form->labelEx($model,'tagtype'); ?>  
11.     <?php echo $form->radioButtonList($model,'tagtype'array(1=>"普通TAG"，2=>"系统默认TAG"),array('separator'=>'','labelOptions'=>array('class'=>'tagtypelabel'))); ?>  
12.   </div>  
13.   <?php echo $form->errorSummary($model); ?>  
14.   <div class="row buttons">  
15.     <?php echo CHtml::submitButton($model->isNewRecord ? '添加' : '修改'); ?>  
16.   </div>  
17. <?php $this->endWidget(); ?> 

模型（models）中rules部分的简单代码：

1. public function rules()  
2. {  
3.   return array(  
4.     array('tagname,tagtype', 'required'),  
5.     array('tagtype', 'numerical', 'integerOnly'=>true),  
6.     array('tagname', 'length', 'max'=>32),  
7.     array('tagname', 'match', 'pattern'=>'/^[\x{4e00}-\x{9fa5}A-Za-z0-9]+$/u',  
8.         'message'=>'标签不合法，必须为汉字、字母或者数字！'),  
9.     array('tagname', 'checktagname', 'on'=>'create,update'),//插入TAG时检查是否已经存在该tag  
10.     array('tagid, tagname, tagtype', 'safe', 'on'=>'search'),  
11.   );  
12. } 

系统默认有这些验证规则：

boolean : CBooleanValidator 的别名, 确保属性的值是CBooleanValidator::trueValue 或 CBooleanValidator::falseValue .

captcha : CCaptchaValidator 的别名,确保了特性的值等于 CAPTCHA 显示出来的验证码.

compare : CCompareValidator 的别名, 确保了特性的值等于另一个特性或常量.

email : CEmailValidator 的别名,确保了特性的值是一个有效的电邮地址.

default : CDefaultValueValidator 的别名, 为特性指派了一个默认值.

exist : CExistValidator 的别名, 确保属性值存在于指定的数据表字段中.

file : CFileValidator 的别名, 确保了特性包含了一个上传文件的名称.

filter : CFilterValidator 的别名, 使用一个filter转换属性.

in : CRangeValidator 的别名, 确保了特性出现在一个预订的值列表里.

length : CStringValidator 的别名, 确保了特性的长度在指定的范围内.

match : CRegularExpressionValidator 的别名, 确保了特性匹配一个正则表达式.

numerical : CNumberValidator 的别名, 确保了特性是一个有效的数字.

required : CRequiredValidator 的别名, 确保了特性不为空.

type : CTypeValidator 的别名, 确保了特性为指定的数据类型.

unique : CUniqueValidator 的别名, 确保了特性在数据表字段中是唯一的.

url : CUrlValidator 的别名, 确保了特性是一个有效的路径.

基本上还是比较全面的，一般的都够用了，但是还是有时候有的验证需要自定义。就以上面的代码为例，我们在添加TAG时需要检查系统之前是否已经存在这个TAG，如果存在则不让用户添加。这个就需要在添加之前去查询数据库，看该TAG是否已经存在，这里我们就需要自定一个验证规则了。

关键有一下两个步骤：

1、在rules中 添加代码：array('tagname', 'checktagname', 'on'=>'create,update'),//插入TAG时检查是否已经存在该tag

注：我在其中用了 'on'=>'create,update'，所以这个验证规则之对create,update场景生效

2、在该模型（models）中添加验证函数：

1. public function checktagname($attribute,$params){  
2.   $oldtag = Tag::model()->findByAttributes(array('tagname'=>$this->tagname));  
3.   if($oldtag->tagid > 0){  
4.     $this->addError($attribute, '该TAG已经存在!');  
5.   }  
6. } 

其中需要说明的是：

（1）该验证函数的参数必须是($attribute,$params)，不能缺少其中任何一个；

（2）$this->addError($attribute, '该TAG已经存在!');这个是你想要在视图中输出的错误提示信息。

就是这么简单，有了这个方法，表单验证的各种想要的规则就都可以自定义了。

下面给大家介绍Yii自定义验证规则

最简单的定义验证规则的方法是在使用它的模型(model)内部定义。

比方说，你要检查用户的密码是否足够安全.

通常情况下你会使用 CRegularExpression 方法验证，但为了本指南，我们假设不存在此验证方法.

首先在模型(model)中添加两个常量

const WEAK = 0;

const STRONG = 1;然后在模型(model)的 rules 方法中设置：

1. /** 
2.  * @return array validation rules for model attributes. 
3.  */ 
4. public function rules() 
5. { 
6.   return array( 
7.     array('password', 'passwordStrength', 'strength'=>self::STRONG), 
8.   ); 
9. } 

确保你写的规则不是一个已经存在的规则，否则将会报错.

现在要做的是在模型(model)中创建一个名称为上面填写的规则的方法(即 passwordStrength)。

1. /** 
2.  * check if the user password is strong enough 
3.  * check the password against the pattern requested 
4.  * by the strength parameter 
5.  * This is the 'passwordStrength' validator as declared in rules(). 
6.  */ 
7. public function passwordStrength($attribute,$params) 
8. { 
9.   if ($params['strength'] === self::WEAK) 
10.     $pattern = '/^(?=.*[a-zA-Z0-9]).{5,}$/';  
11.   elseif ($params['strength'] === self::STRONG) 
12.     $pattern = '/^(?=.*\d(?=.*\d))(?=.*[a-zA-Z](?=.*[a-zA-Z])).{5,}$/';  
13.       
14.   if(!preg_match($pattern, $this->$attribute)) 
15.    $this->addError($attribute, 'your password is not strong enough!'); 
16. } 

刚才创建的方法需要两个参数：* $attribute 需要验证的属性* $params 在规则中自定义的参数，在模型的 rules 方法中我们验证的是 password 属性，所以在验证规则中需要验证的属性值应该是 password.

在 rules 方法中我们还设置了自定义的参数 strength，它的值将会放到 $params 数组中.

你会发现在方法中我们使用了 CModel::addError().

添加错误接受两个参数：第一个参数是在表单中显示错误的属性名，第二个参数时显示的错误信息 。

完整的方法:继承 CValidator 类

如果你想把规则使用在多个模型(model)中，最好的方法时继承 CValidator 类。

继承这个类你可以使用像 CActiveForm::$enableClientValidation (Yii 1.1.7 版本后可用) 类似的其他功能。

创建类文件

首先要做的是创建类文件.最好的方法时类的文件名和类名相同，可以使用 yii 的延迟加载(lazy loading)功能。

让我们在应用(application)的扩展(extensiions)目录(在 protected 文件夹下)下新建一个文件夹.

将目录命名为: MyValidators

然后创建文件: passwordStrength.php

在文件中创建我们的验证方法

1. class passwordStrength extends CValidator 
2. { 
3.   public $strength; 
4.   private $weak_pattern = '/^(?=.*[a-zA-Z0-9]).{5,}$/'; 
5.   private $strong_pattern = '/^(?=.*\d(?=.*\d))(?=.*[a-zA-Z](?=.*[a-zA-Z])).{5,}$/'; 
6. ... 
7. } 

在类中创建属性，此属性为在验证规则中使用的参数.

CValidator 会自动根据参数来填充这些属性.

我们也创建了两个其他的属性，它们为 preg_match 函数使用的正则表达式.

现在我们应该重写父类的抽象方法(abstract method) validateAttribute

1. /** 
2.  * Validates the attribute of the object. 
3.  * If there is any error, the error message is added to the object. 
4.  * @param CModel $object the object being validated 
5.  * @param string $attribute the attribute being validated 
6.  */ 
7. protected function validateAttribute($object,$attribute) 
8. { 
9.   // check the strength parameter used in the validation rule of our model 
10.   if ($this->strength == 'weak') 
11.    $pattern = $this->weak_pattern; 
12.   elseif ($this->strength == 'strong') 
13.    $pattern = $this->strong_pattern; 
14.   // extract the attribute value from it's model object 
15.   $value=$object->$attribute; 
16.   if(!preg_match($pattern, $value)) 
17.   { 
18.     $this->addError($object,$attribute,'your password is too weak!'); 
19.   } 
20. } 

上面的方法我认为就不用解释了.当然你也可以在 if 的条件中使用常量，我推荐使用.

Tags: models rules自定义验证规则

分享到：