ThinkPHP3.2完全开发手册

ThinkPHP系列开发手册在线版

字段映射

ThinkPHP的字段映射功能可以让你在表单中隐藏真正的数据表字段,而不用担心放弃自动创建表单对象的功能,假设我们的User表里面有username和email字段,我们需要映射成另外的字段,定义方式如下:

namespace Home\Model;
use Think\Model;
Class UserModel extends Model{
     protected $_map = array(
         'name' =>'username', // 把表单中name映射到数据表的username字段
         'mail'  =>'email', // 把表单中的mail映射到数据表的email字段
     );
}

这样,在表单里面就可以直接使用name和mail名称作为表单数据提交了。我们使用create方法创建数据对象的时候,会自动转换成定义的实际数据表字段。

字段映射还可以支持对主键的映射。

使用字段映射后,默认不会对读取的数据会自动处理,

// 实例化User模型
$User = D('User');
$data = $User->find(3);
dump($data);

输出结果类似:

array(size=4)
    'id'      => int 3
    'username'=> string 'thinkphp'(length=8)
    'email'   => string 'thinkphp@gmail.com' (length=18)
    'status'  => int 1

这个时候取出的data数据包含的是实际的username和email字段。

如果我们需要在数据获取的时候自动处理的话,设置开启READ_DATA_MAP参数,

'READ_DATA_MAP'=>true

这个时候,输出结果类似:

array(size=4)
    'id'      => int 3
    'name'    => string 'thinkphp'(length=8)
    'mail'    => string 'thinkphp@gmail.com' (length=18)
    'status'  => int 1

或者直接使用parseFieldsMap方法进行转换处理,例如:

// 实例化User模型
$User = D('User');
$data = $User->find(3);
$data = $User->parseFieldsMap($data);

通过上面的两种方式后,无论是find还是select方法读取后的data数据中就包含了name和mail字段数据了,而不再有username和email字段数据了。