一、多表關聯的配置
在我們使用 AR 執行關聯查詢之前,我們需要讓 AR 知道一個 AR 類是怎樣關聯到另一個的。
兩個 AR 類之間的關系直接通過 AR 類所代表的數據表之間的關系相關聯。 從數據庫的角度來說,表 A 和 B 之間有三種關系:一對多(one-to-many,例如 tbl_user 和 tbl_post),一對一( one-to-one 例如 tbl_user 和 tbl_profile)和 多對多(many-to-many 例如 tbl_category 和 tbl_post)。 在 AR 中,有四種關系:
BELONGS_TO(屬於): 如果表 A 和 B 之間的關系是一對多,則 表 B 屬於 表 A (例如 Post 屬於 User);
HAS_MANY(有多個): 如果表 A 和 B 之間的關系是一對多,則 A 有多個 B (例如 User 有多個 Post);
HAS_ONE(有一個): 這是 HAS_MANY 的一個特例,A 最多有一個 B (例如 User 最多有一個 Profile);
MANY_MANY: 這個對應於數據庫中的 多對多 關系。 由於多數 DBMS 不直接支持 多對多 關系,因此需要有一個關聯表將 多對多 關系分割為 一對多 關系。 在我們的示例數據結構中,tbl_post_category 就是用於此目的的。在 AR 術語中,我們可以解釋MANY_MANY 為 BELONGS_TO 和 HAS_MANY 的組合。 例如,Post 屬於多個(belongs to many) Category ,Category 有多個(has many) Post.
AR 中定義關系需要覆蓋 CActiveRecord 中的 relations() 方法。此方法返回一個關系配置數組。每個數組元素通過如下格式表示一個單一的關系。
'VarName'=>array('RelationType', 'ClassName', 'ForeignKey', ...additional options)
其中 VarName 是關系的名字;RelationType 指定關系類型,可以是一下四個常量之一: self::BELONGS_TO, self::HAS_ONE,self::HAS_MANY and self::MANY_MANY;ClassName 是此 AR 類所關聯的 AR 類的名字; ForeignKey 指定關系中使用的外鍵(一個或多個)。
需要弄清楚的幾點:
(1),VarName指什麼? 詳見下面例2。
(2),RelationType。一共有4種,分別為
self::HAS_MANY, self::BELONGS_TO, self::MANY_MANY, self::HAS_ONE。
(3),ClassName。即關聯的另一個../model/類名.php。
(4),ForeignKey。誰是誰的外鍵?
(5),附加條件
ER Diagram
例1,一對多與多對一關系(post和user之間的關系)
1)models/Post.php
class Post extends CActiveRecord { ...... public function relations() { return array( 'author'=>array(self::BELONGS_TO, 'User', 'author_id'), ); } }
其中Post與User的關系是BELONGS_TO(多對一)關系,並通過Post的author_id與User關聯。
Post中author_id是外鍵,關聯到User中。
注:此處的VarName是author,一個對象。
(2)models/User.php
class User extends CActiveRecord { ...... public function relations() { return array( 'posts'=>array(self::HAS_MANY, 'Post', 'author_id'), 'profile'=>array(self::HAS_ONE, 'Profile', 'owner_id'), ); } }
對於User,與Post的關系是屬於HAS_MANY(一對多)關系。並通過Post的author_id與Post關聯。
例2,多對多關系
在FailParts.php中
'Users' => array(self::MANY_MANY, 'User', 'fail_parts_user(fail_parts_id, user_id)'),
在User.php中
'FailParts' => array(self::MANY_MANY, 'FailParts', 'fail_parts_user(user_id, fail_parts_id)'),
由於兩者是多對多關系,所以要用Users,而不是User;要用FailParts,而不是FailPart。
此處的Users和FailParts,即為前面的VarName。
例3,一對一關系
比較簡單,暫略。
2,關於VarName。
對於類A.php,'VarName'=>array('RelationType', 'B', 'ForeignKey', ...additional options)
其中VarName與B基本相同。但未必完全一樣。此時就可以在A的views/A/xx.php中通過VarName來訪問B及其屬性值了。
如果是一對一:A->VarName
如果是多對一:author_name = $post->Author->name;
如果是一對多:$posts = $author->Post;
如果是多對多:$posts = $author->Post;//本質是拆成一對多和多對一
foreach($posts as $u){ $_tmp_titles[] = $u -> title; } titleStr = implode(', ', $_tmp_titles);
二、多表關聯的使用
常常在controllers裡
1,延時加載
(1)多對一
$post = Post::model()->findByPk(10);
$author = $post->author;
批注:此處本質是一對一。
(2)一對多
$user = User::model()->findByPk(10);
$posts = $user->posts;
(3)多對多
需要重點注意:兩個id有先後關系。
站在$repairInfo實例的角度,關聯關系必須是
'FailParts' => array(self::MANY_MANY, 'FailParts', 'repair_mapping(repair_info_id,fail_parts_id)'),
而站在$failParts實例的角度,則關聯關系變為
'RepairInfos' => array(self::MANY_MANY, 'RepairInfo', 'repair_mapping(fail_parts_id, repair_info_id)'),
而前面也已經指出,不需要雙方都配置,只需需要的一方設置即可。
之前曾使用過的笨方法:
/*方法一:使用表關系(多對多)*/ $fails = $repairInfo->FailParts;//在$repairInfo中使用 /*方法二:使用原始方法*/ $id = $repairInfo->id; $maps = RepairMapping::model()->findAll("repair_info_id = $id"); $f_ids = array(); foreach($maps as $map){ array_push($f_ids, $maps[0]->fail_parts_id); } $f_idsStr = implode(',',$f_ids); $fails = FailParts::model()->findAll("id IN ($f_idsStr)");
2,主動加載——with
(1)一對多
(2)多對多
$posts = Post::model()->('author')->findAll();
例子:
User.php
//查詢一個機房$idc_id的所有用戶 function getAdminedUsersByIdc($idc_id){ $c = new CDbCriteria(); $c->join = "JOIN idc_user on t.id=idc_user.user_id"; $c->condition = "idc_user.idc_id=$idc_id"; return User::model()->with('Idcs')->findAll($c); } //規則中配置 'Idcs' => array(self::MANY_MANY, 'Idc', 'idc_user(user_id, idc_id)'),
批注:沒有with('Idcs'),執行後的結果也一樣。只不過不再是eager loading。
三、帶參數的關聯配置
常見的條件有
1,condition 按某個表的某個字段加過濾條件
例如:
//在User的model裡定義,如下關聯關系 'doingOutsources' => array(self::MANY_MANY, 'Outsource', 'outsource_user(user_id, outsource_id)', 'condition' => "doingOutsources.status_id IN(" . Status::ASSIGNED . "," . Status::STARTED ."," . Status::REJECTED .")"),
//結論:condition是array裡指定model的一個字段。
顯然,doingOutsources是真實數據表Outsource的別名,所以在condition中可以使用doingOutsources.status_id,當然也可以使用Outsource.status_id。另本表名user的默認別名是t。
2,order 按某個表的某個字段升序或降序
//在RepairInfo的model裡定義,如下關聯關系 'WorkSheet' => array(self::HAS_MANY, 'WorkSheet', 'repair_info_id', order => 'created_at desc'), //調用 $worksheets = $repair_info->WorkSheet; //此時$worksheets是按降序排列
//結論:order是array裡指定model的一個字段。
with
joinType
select
params
on
alias
together
group
having
index
還有用於lazy loading的
limit 只取5個或10個
offset
through
官方手冊
'posts'=>array(self::HAS_MANY, 'post', 'author_id', 'order'=>'posts.create_time DESC', 'with'=>'categories'),
四、靜態查詢(僅用於HAS_MANY和MANY_MANY)
關鍵字:self:STAT
1,基本用法。例如,
class Post extends CActiveRecord { ...... public function relations() { return array( 'commentCount'=>array(self::STAT, 'Comment', 'post_id'), 'categoryCount'=>array(self::STAT,'Category','post_category(post_id, category_id)'); ); } }
2,靜態查詢也支持上面的各種條件查詢
如
'doingOutsourceCount' => array(self::STAT, 'Outsource', 'outsource_user(user_id, outsource_id)', 'condition' => "outsource.status_id IN(" . Status::ASSIGNED . "," . Status::STARTED ."," . Status::REJECTED .")"),
其他查詢還包括
condition 使用較多
order
select
defaultValue
params
group
having
3,靜態查詢的加載方式
可以使用lazy loading方式
$post->commentCount.
也可以使用eager loading方式
$posts = Post::model()->with('commentCount','categoryCount')->findAll();
注with中字符串一定是別名。
兩者的性能比較:
如果需要取所有post的所有comment,前者需要2N+1次查詢,而後者只有一次。兩者的選擇視情況而定。