thinkphp框架中“关联操作”的完整定义详解
浏览数：33 /
时间：2015年06月09日
转自：http://www.phpthink.cn/html/221.html
完整定义的格式是：
‘该表的关联方式的属性1‘ => ‘定义‘,
‘该表的关联方式的属性N‘ => ‘定义‘,
),
‘关联表名2‘ => array(
‘该表的关联方式的属性1‘ => ‘定义‘,
‘该表的关联方式的属性N‘ => ‘定义‘,
),
...
);
在上面的格式描述中，对于属性我们使用了一个修饰词：该表的关联方式的属性。
我们换一种方式去啃下这个最麻烦的难点，先来了解所有允许定义的属性含义，然后再按照各种关联关系去对号入座。
class UserModel extends Model{
protected $_link = array(
‘Area‘=>array(
‘mapping_type‘=> BELONGS_TO,
‘mapping_name‘=> ‘Area‘,
‘class_name‘ => ‘Area‘,
‘foreign_key‘ => ‘area_id‘,
),
);
}
上面代码中，mapping_type,foreign_key ...这些，就是允许定义的属性
-------------------------所有可定义的属性概述-------------------------------- mapping_type
-------------------------所有可定义的属性概述-------------------------------- mapping_type
用以定义该表与主表的关联类型mapping_type所定义的内容必须是常量，共有下面四种方式：
Belongs_to 表示当前模型从属于另外一个父对象，例如每个会员都从属于一个地区
HAS_MANY 表示当前模型拥有多个子对象，例如每个用户有多个兴趣消费卡
MANY_TO_MANY 表示当前模型可以属于多个对象，而父对象则可能包含有多个子对象，通常两者之间需要一个中间表类约束和关联。例如本例中的每个会员可以属于多个兴趣组，每个兴趣组可以有多个用户
class_name
要关联的模型类名称。
例如示例代码所定义的Area，再次提醒，一定要确保已定义了此模型类(AreaModel)。
mapping_name
该名称不能与当前模型的字段重复，否则会导致关联数据获取的冲突mapping_name没有定义的话，会取class_name的定义作为mapping_name。即模型类名称
foreign_key
关联的外键名称
foreign_key如果没定义，则默认是 当前数据对象名称+_id 作为外键
那么think_user表的外键默认为user_id，如果不是，就用该属性进行显式指定，例如数据表定义的外键是userId,则使用‘foreign_key‘=>‘userId‘,这种方式去申明
Condition
关联条件，在关联查询的时候会自动带上外键的值，如果有额外的查询条件，可以使用该属性进行定义
mapping_fields
关联要查询的字段
如果没有定义，默认关联查询的关联数据是该关联表的全部字段。
如果仅仅是需要查询其中的个别字段，可以使用该属性进行指定
as_fields
直接把关联的字段值映射成数据对象中的某个字段
这个特性是ONE_TO_ONE(包括HAS_ONE 和 BELONGS_TO)关联关系特有的，可以直接把关联数据映射到数据对象中，而不是作为一个关联数据。例如当关联数据的字段名和当前数据对象的字段名称有冲突时，可以使用下面这种方式进行定义：
‘as_fields‘=>‘email,nickname:username‘,没有定义该属性时数据类似于：
["id"] => string(1) "2"
["name"] => string(8) "thinkphp"
["Card"] => array(1) {
[0] => array(1) {
["card"] => string(8) "88888888"
}
如果定义了映射，则类似于
["id"] => string(1) "2"
["name"] => string(8) "thinkphp"
["card"] => string(8) "88888888"
parent_key
自引用关联的关联字段
默认为parent_id (BELONGS_TO和HAS_MANY才有此属性)
自引用关联是一种比较特殊的关联，也就是关联表就是当前表。
mapping_limit
关联要返回的记录数目(HAS_MANY和MANY_TO_MANY才有此属性)
mapping_order
关联查询的排序 (HAS_MANY和MANY_TO_MANY才有此属性)
relation_foreign_key
关联表的外键名称 (MANY_TO_MANY独有属性)
默认的关联表的外键名称是 表名+_id
例如本示例中的relation_foreign_key是group_id
如果不符合，可通过此属性进行指定
relation_table
关联的中间表名称 (MANY_TO_MANY独有属性)
例如当前模型是User，关联模型是Group，那么关联表的名称会默认使用user_group这样的格式。
默认的中间表命名规则是：
如果两个表存在一个对应的中间表，该中间表的命名方式为
数据表前缀+_ +关联操作的主表名+_+关联表名
例如本示例中，由think_user表操作关联表,所以和think_group表的中间表名称是think_user_group，如果是从think_group表来操作，那么中间命名是think_group_user，也就是说，多对多关联的设置，必须有一个Model类里面需要显式定义中间表，否则双向操作会出错。
另外，中间表的字段无需要有id主键，(不过就算建立了这个字段也不会影响中间表操作的)中间表通常只是由 user_id 和 group_id 构成就可以了。
如果中间表不符合上面的规则，则需要通过该属性去显式指定中间表名称。
HAS_ONE 可用属性
mapping_type
class_name
mapping_name
foreign_key
condition
mapping_fields
as_fields
BELONGS_TO 可用属性
mapping_name
foreign_key
mapping_fields
condition
parent_key
as_fields
HAS_MANY 可用属性
mapping_name
foreign_key
parent_key
mapping_fields
mapping_limit
mapping_order
MANY_TO_MANY 可用属性
mapping_name
foreign_key
elation_foreign_key
mapping_limit
mapping_order
relation_table
关联定义好后，我们就可以轻松使用关联操作了。
以下示例代码来自官方总工程师的关联操作示例，先贴出所有代码再对重点要注意的地方进行讲解。
<?php
class IndexAction extends Action{
public function index(){
$User = D("User");
/*-------------- 关联写入 -------------------------------*/
// 添加用户数据
$User->name = ‘thinkphp‘;
$User->area_id = 1;//东区
// 用户档案数据
$User->UserInfo = array(
‘email‘ =>‘[email protected]‘,
‘nickname‘ =>‘流年‘,
);
// 用户的消费卡数据
$User->Card = array(
array(‘id‘=>1,‘card‘=>‘12345678‘),// 消费卡帐号1
array(‘id‘=>2,‘card‘=>‘88888888‘),// 消费卡帐号2
);
// 用户的所属兴趣组数据
$User->Group = array(
array(‘id‘=>1),// 琴
array(‘id‘=>2),// 棋
);
// 关联添加用户数据
$id = $User->relation(true)->add();
// 如果用户数据不是User模型 而是一个Data数组
// 可以使用
// $id = $User->relation(true)->add($Data);
$this->assign(‘info1‘, ‘用户数据关联写入完成！‘);
/*-------------- 关联查询 -------------------------------*/
$user = $User->relation(true)->find($id);
$this->assign(‘user1‘,$user);
$user = $User->relation(‘UserInfo‘)->find($id);
$this->assign(‘user2‘,$user);
$list = $User->relation(true)->findAll();
$this->assign(‘list‘,$list);
/*-------------- 关联更新 -------------------------------*/
$user[‘id‘] = $id;
$user[‘name‘] = ‘tp‘;
// HAS_ONE 关联数据的更新直接赋值
$user[‘UserInfo‘][‘email‘] = ‘[email protected]‘;
// 注意HAS_MANY 的关联数据要加上主键的值
// 可以更新部分数据
$user[‘Card‘] = array(
array(‘id‘=>1,‘card‘=>‘66666666‘), // 更新主键为1的记录
array(‘card‘=>‘77777777‘),// 增加一条新的记录
);
// MANY_TO_MANY 的数据更新是重新写入
$user[‘Group‘] = array(
array(‘id‘=>2),
);
$User->where(‘id=‘.$id)->relation(true)->save($user);
// 查询更新后的数据
$user = $User->relation(true)->find($id);
$this->assign(‘user3‘,$user);
/*-------------- 关联删除 -------------------------------*/
$User->relation(true)->delete($id);
/*--------------------------------------------------------*/
$this->assign(‘info2‘, ‘用户ID为‘.$id.‘的数据已经关联删除！‘);
$this->assign(‘id‘,$id);
$this->display();
}
}
?>
代码注解：
TP关联操作支持手动关联和自动关联，我们看到上面代码使用的是手动关联，通过在连贯操作中的relation()方法进行控制，如果需要自动关联操作，可以在UserModel中设置相应属性。
class UserModel extends RelationModel{
protected $autoSaveRelations = true; // 自动关联保存
protected $autoDelRelations = true; // 自动关联删除
protected $autoAddRelations = true; // 自动关联写入
protected $autoReadRelations = true; // 自动关联查询
protected $_link = array(....);
}
例如当设置了自动关联查询属性为true时，使用$User->select()，系统会自动把所有定义的关联数据都查询出来，自动关联的应用可以自己进行测试体验，官方的建议是：当给模型定义了多个关联的时候，要尽量避免使用自动关联操作，以免影响性能。
再来看上面的代码，插入数据时我们使用了这种方式：
// 用户档案数据
$User->UserInfo = array(
‘email‘ =>‘[email protected]‘,
‘nickname‘ =>‘流年‘,
);
是因为我们以User模型为核心对其它模型类进行关联定义的，其它模型类的mapping_name属性所定义的值，会被映射到User数据对象中成为User数据对象的其中一个属性，黙认mapping_name属性是关联的模型类名称。
如果是ONE_TO_ONE关联关系，并且定义了as_fields字段映射，则as_fields所设置的字段，会直接作为user数据对象的字段，这种情况在数据处理方式上，和单表模型是相同的，即直接赋值就可以：
$User->email = ‘[email protected]‘;
$User->nickname = ‘流年‘;
relation()方法在ThinkPHP1.6版中进行了改进，简化了以前的几种我们所熟悉的xFind(),xFindAll(),relationGet(),relationAdd(),relationSave(),relationDel()这些方法，全部整合到了新定义的relation()中，直接支持使用参数进行连贯操作。
当需要进行关联处理时，我们使用relation(ture)这种方式:
$id = $User->relation(true)->add();
如果要指定关联数据，可以如34行代码中那样，在relation方法中传入参数：
$user =$User->relation(‘UserInfo‘)->find($id);
至于关联更新的需要注意的是HAS_ONE 关联数据的更新直接赋值则可，
$user[‘UserInfo‘][‘email‘] = ‘[email protected]‘;
如果是HAS_MANY 的关联数据则要加上主键的值，可以更新部分数据或添加新的数据
$user[‘Card‘] = array(
array(‘id‘=>1,‘card‘=>‘66666666‘), // 更新主键为1的记录
array(‘card‘=>‘77777777‘),// 增加一条新的记录
);
MANY_TO_MANY关联在插入和更新时，都会自动先将原来关联的数据删除再进行处理。
郑重声明：本站内容如果来自互联网及其他传播媒体，其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。
