YII框架分析笔记3:表单模型和验证
表单模型CFormModel绝大部分继承CModelCModel,由于表模型数据不需要持久化,所以主要在验证操作上。下面以框架脚手架生成的网站登录为例说明表单模型。
- //模型中的验证规则
- public function rules()
- {
- return array(
- array('username, password', 'required'),
- array('rememberMe', 'boolean'),
- array('password', 'authenticate'),
- );
- }
- $model=new LoginForm;//创建一个登录表单模型
- $model->attributes=$_POST['LoginForm'];//传入登录数据
- CModel->setAttributes($values,$safeOnly=true)//调用CModel的setter方法
- //返回model中relues中定义的安全数据,经过下面的调用流程获取一个验证器集合
- //每个验证器由CValidator::createValidator($rule[1],$this,$rule[0],array_slice($rule,2))
- CModel->getValidators()
- ->createValidators()
- ->rules()
- CModel->validate();//遍历验证器执行验证
验证器内部实现
表单模型核心部分在验证上,下面探讨其实现方式。
YII框架中验证以独立组件集合的形式存在,CValidator是所有验证器的基类。还是以登录验证为例。rules方法中包含required、boolean、authenticate三个验证器
- public static function createValidator($name,$object,$attributes,$params=array())
- {
- if(is_string($attributes))
- $attributes=preg_split('/[\s,]+/',$attributes,-1,PREG_SPLIT_NO_EMPTY);
- if(isset($params['on']))
- {
- if(is_array($params['on']))
- $on=$params['on'];
- else
- $on=preg_split('/[\s,]+/',$params['on'],-1,PREG_SPLIT_NO_EMPTY);
- }
- else
- $on=array();
- if(method_exists($object,$name))
- {
- $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'];
- }
- else
- {
- $params['attributes']=$attributes;
- if(isset(self::$builtInValidators[$name]))
- $className=Yii::import(self::$builtInValidators[$name],true);
- else
- $className=Yii::import($name,true);
- $validator=new $className;
- foreach($params as $name=>$value)
- $validator->$name=$value;
- }
- $validator->on=empty($on) ? array() : array_combine($on,$on);
- return $validator;
- }
创建验证器流程
1、获取属性(array $attributes)和使用场景(array $on)
2、判断验证器是否存在model中,如果存在创建一个内联验证器CInlineValidator,如果不存在,执行第3步
3、如果验证器是框架自带的导入自带验证器,否则导入外部验证器,然后实例化并赋值。
当触发validate()时候,可能产生的错误将被存储在model中,可以通过调用 CModel::getErrors() 和CModel::getError() 提取这些错误信息。