thinkphp模型自动完成中的ignore

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