ThinkPHP中的模型有一个自动完成的功能,非常好用。我们经常在对用户的密码进行加密的时候使用这个功能,比如一个用户注册的时候,我们写一个模型方法,直接完成注册,而在数据插入到数据库之前,自动对密码字段进行了加密。
Model User; $_auto = array( array(password,md5) );
function register($username,$password)
上面的$username和$password都是用户提交的信息,而在数据库中,我们查看数据,发现密码字段已经自动加密了。但是,有一个情况比较复杂,就是在用户更新数据的时候。
function update($uid,$password,$data) { $this->check_pass($uid,$password); $this->create($data,self::MODEL_UPDATE); $this->save(); }
我们一般的情况是:需要输入原始密码进行校验,校验通过后才能修改密码。但是也有一个情况是,用户并不希望修改密码,所以新密码字段留空,而修改了其他字段。这种情况下,ThinkPHP提供了一个ignore(忽略,不处理)的自动完成条件来处理。如下:
protected $_auto = array( array('password', '', self::MODEL_UPDATE, 'ignore'), // 解释一下,第一个元素是指字段名,第二个元素是指当该字段的值为什么的时候执行忽略操作(不一定为空,也可以是其他值) );
当提交的密码为空的时候,就会执行ignore动作。但是ThinkPHP的官方文档中,并没有说明,当两个自动完成同时使用的时候,应该怎么处理,比如password既要执行md5又要执行ignore时应该怎么处理。所以,我们必须去把自动完成的源码翻出来进行剖析。
自动完成的源码在/ThinkPHP/Library/Think/Model.class.php文件中的autoOperation函数来实现:
/** * 自动表单处理 * @access public * @param array $data 创建数据 * @param string $type 创建类型 * @return mixed */ private function autoOperation(&$data,$type) { if(false === $this->options['auto']) { // 关闭自动完成 return $data; } if(!empty($this->options['auto'])) { $_auto = $this->options['auto']; unset($this->options['auto']); } elseif(!empty($this->_auto)) { $_auto = $this->_auto; } // 自动填充 if(isset($_auto)) { foreach ($_auto as $auto) { // 填充因子定义格式 // array('field','填充内容','填充条件','附加规则',[额外参数]) if(empty($auto[2])) $auto[2] = self::MODEL_INSERT; // 默认为新增的时候自动填充 if( $type == $auto[2] || $auto[2] == self::MODEL_BOTH) { if(empty($auto[3])) $auto[3] = 'string'; switch(trim($auto[3])) { case 'function': // 使用函数进行填充 字段的值作为参数 case 'callback': // 使用回调方法 $args = isset($auto[4]) ? (array)$auto[4] : array(); if(isset($data[$auto[0]])) { array_unshift($args,$data[$auto[0]]); } if('function'==$auto[3]) { $data[$auto[0]] = call_user_func_array($auto[1], $args); } else { $data[$auto[0]] = call_user_func_array(array(&$this,$auto[1]), $args); } break; case 'field': // 用其它字段的值进行填充 $data[$auto[0]] = $data[$auto[1]]; break; case 'ignore': // 为空忽略 if($auto[1]===$data[$auto[0]]) unset($data[$auto[0]]); break; case 'string': default: // 默认作为字符串填充 $data[$auto[0]] = $auto[1]; } if(isset($data[$auto[0]]) && false === $data[$auto[0]] ) unset($data[$auto[0]]); } } } return $data; }
上面是实现自动完成的源码,可以看到,核心代码用红色标注出来,当采用ignore作为动作行为选项时,判断array的第二个元素和传过来的数据(如$_POST)的对应字段是否有相同的值(全等,所以null !== '',要注意),如果全等,就直接unset这个字段,这样在更新的时候就不会更新这个字段。
如果我们有两条语句,如下:
protected $_auto = array( array('password', '', self::MODEL_UPDATE, 'ignore'), array('password', 'md5', self::MODEL_UPDATE, 'function') );
那么,无论你如何改变这两个条件的顺序,都会导致密码被md5加密,只是顺序不同,加密的结果不同而已。那么这是由什么产生的呢?是由上面源码中的蓝色标识代码产生的。$_auto的每一个元素数组都会被执行,案例中的第二个自动完成不会自动消失,而是会执行:md5在前面执行,和在后面执行,都会产生结果。
那么怎么来达到我们的目的呢?其实很简单,我们反而是利用foreach这个本质规律,先执行一个我们自己写的加密函数,如果结果为空,那么再执行ignore即可。代码如下:
protected $_auto = array( array('password', 'md5_password', self::MODEL_UPDATE, 'callback'), array('password', '', self::MODEL_UPDATE, 'ignore') ); protected function md5_password($password) { if(!$password) return ''; return md5($password); }
我们利用到了另外一个自动完成的规则,及callback。它实际上和function是一样的,只不过callback调用的是本模型类的一个方法而已,实际上,我们也可以自己在common中写一个函数来达到这个效果。
要注意自动完成的顺序,当第一个规则执行完之后,我们来看一下。如果你传过来的密码是空的,那么md5_password函数返回的值是'',而再去执行第二个自动完成规则ignore时,password字段就被忽略了。这样就达到了我们要的目的。
有两个注意点:1.自动完成规则的顺序必须是先执行md5_password函数,然后在执行ignore;2.md5_password在忽略条件下必须返回和ignore要忽略的值相同的值。
2015-11-24 5765