Yii1.1的验证规则

在Yii1.1的数据验证是由CValidator完成,在CValidator中提供了各种基本的验证规则

<?php
public static $builtInValidators=array(
'required'=>'CRequiredValidator',
'filter'=>'CFilterValidator',
'match'=>'CRegularExpressionValidator',
'email'=>'CEmailValidator',
'url'=>'CUrlValidator',
'unique'=>'CUniqueValidator',
'compare'=>'CCompareValidator',
'length'=>'CStringValidator',
'in'=>'CRangeValidator',
'numerical'=>'CNumberValidator',
'captcha'=>'CCaptchaValidator',
'type'=>'CTypeValidator',
'file'=>'CFileValidator',
'default'=>'CDefaultValueValidator',
'exist'=>'CExistValidator',
'boolean'=>'CBooleanValidator',
'safe'=>'CSafeValidator',
'unsafe'=>'CUnsafeValidator',
'date'=>'CDateValidator',
);
?>

在Model文件中只需要定义rules方法便可以使用验证规则

  public function rules()
{
return array(
array('bianhao, status', 'required','message'=>'{attribute}为必填项目'), //bianhao,status是必须的;message:提供错误信息提示
array('lie, hang, status', 'numerical', 'integerOnly'=>true), //lie,hang,statusbi必须是数字而且必须是整形
array('bianhao', 'length', 'max'=>10), //bianhao的长度最多是10位
);
}

在验证数据有效性的时候,框架提供给我们的验证规则可能满足不了需求,这时候需要自定义验证规则,在ThinkPhp中我们需要新建一个验证规则文件,这显得就比较麻烦了,那Yii是如何解决这个问题的呢?Yii提供了一个CInlineValidator类来处理这个问题

<?php
if(method_exists($object,$name)) //$object当前验证的模型类
{
$validator=new CInlineValidator;
$validator->attributes=$attributes;
$validator->method=$name;
if(isset($params['clientValidate']))
{
$validator->clientValidate=$params['clientValidate'];
unset($params['clientValidate']);
}
$validator->params=$params;
if(isset($params['skipOnError']))
$validator->skipOnError=$params['skipOnError'];
}
?>

只要在当前的验证模型中存在该验证方法那么就绑定到CInlineValidator类中而在CInlineValidator中我们可以看到

<?php
protected function validateAttribute($object,$attribute)
{
$method=$this->method;
$object->$method($attribute,$this->params);
}
?>

可以看出,在Yii1.1中自定义验证只需要在当前Model中创建就可以了

<?php
public function rules()
{
return array(
array('lie,hang',"checkNumber","message"=>"{attribute}的值必须小于10"), //自定义checkNumber方法
);
} /**
* checkNumber方法
* 验证值是否小于10
*/
public function checkNumber($attribute,$params=array()){
if($this->$attribute>10){
$tihuan['{attribute}']=$this->getAttributeLabel($attribute);
$this->addError($attribute,strtr($params["message"],$tihuan));
}
}
?>

注意:在验证函数中不能直接return必须将错误信息addError

在验证数据有效性的时候我们必须还需要考虑场景的问题,不同的场景需要提供不同的验证规则,这点在ThinkPHP5中已经讨论过,Tp5的解决方案是比较繁琐而且不灵活的,那在Yii1.1中是怎么解决的呢?

Yii1.1的CVaildate提供了"on"属性和"except"属性,而在CActiveRecord中初始化中我们可以看到

    public function __construct($scenario='insert')
{
if($scenario===null) // internally used by populateRecord() and model()
return; $this->setScenario($scenario); //我们先看这个这是表示为模型设置一个应用场景
$this->setIsNewRecord(true);
$this->_attributes=$this->getMetaData()->attributeDefaults; $this->init(); $this->attachBehaviors($this->behaviors());
$this->afterConstruct();
}

在CActiveRecord初始化时我们就需要为该模型设置一个应用场景,默认应用场景为"insert"。再来看CModel中是如何获取当前需要验证的Vaildator集合的

     public function getValidators($attribute=null)
{
if($this->_validators===null)
$this->_validators=$this->createValidators();
$validators=array();
$scenario=$this->getScenario();
foreach($this->_validators as $validator)
{
if($validator->applyTo($scenario))
{
if($attribute===null || in_array($attribute,$validator->attributes,true))
$validators[]=$validator;
}
}
return $validators;
}

代码3-4行:获取当前所有验证规则

代码6行:获取当前模型验证规则

代码7-14行:在这个foreach循环里筛选符合当前场景的集合,我们看下$validator->applyTo($scenario) 在CValidator中

     public function applyTo($scenario)
{
if(isset($this->except[$scenario]))
return false;
return empty($this->on) || isset($this->on[$scenario]);
}

代码3-4行:当前场景是否在$this->except中如果在则除掉该验证规则

代码5行:当前验证规则如果没有on属性则保留该验证规则,如果有on属性并且当前场景在$this->on中则保留该规则如果不在则去除

到这,能发现在CValidator中"on"表示该验证规则属于哪个场景(scenario),如果没有"on"属性则该验证规则属于任何场景,如果有"on"属性的话则该验证规则只能属于该on属性下的验证规则;而"except"则恰恰相反,设置了"except"属性就表示该验证规则一定不属于"except"下的场景

看下简单的例子

   public function rules()
{
return array(
array('lie,hang',"checkNumber","message"=>"{attribute}的值必须小于10","on"=>"update,insert"),
array('bianhao, status', 'required',"message"=>'{attribute}为必填项目',"except"=>"insert"),
array('lie, hang, status', 'numerical', 'integerOnly'=>true),
array('bianhao', 'length', 'max'=>10),
);
}

代码4行:该验证规则只能属于update,insert下两个应用场景

代码5行:该验证规则不属于insert应用场景

代码6-7行:该验证规则属于任何应用场景

想要使用不同场景该怎么办?很简单只需要初始化的时候指定场景就好了 $model=new Model($scenario),如果想改变场景怎么办?直接调用$model->setScenario(scenario)就可以了。

总结:对比下与Tp5的验证规则,Yii1.1的显得更加简洁轻便,对不同场景的调用也更加灵活,自定义验证方法也只需要在Model本身添加自定义函数即可。

ps:Yii1.1还提供了前端JS的数据验证方法,但是我表示不太喜欢在PHP中写前端的JS代码,分开一点不是更好么

上一篇:mysql大小写敏感与校对规则


下一篇:"Chinese_PRC_CI_AS" 和 "Chinese_PRC_90_CI_AI" 之间的排序规则冲突问题