## 一對一關聯 ### 關聯定義 定義一對一關聯，例如，一個用戶都有一個個人資料，我們定義`User`模型如下： ~~~ <?php namespace app\model; use think\Model; class User extends Model { public function profile() { return $this->hasOne(Profile::class); } } ~~~ `hasOne`方法的參數包括： >[info] ### hasOne('關聯模型類名', '外鍵', '主鍵'); 除了關聯模型外，其它參數都是可選。 * **關聯模型**（必須）：關聯模型類名 * **外鍵**：默認的外鍵規則是當前模型名（不含命名空間，下同）+`_id` ，例如`user_id` * **主鍵**：當前模型主鍵，默認會自動獲取也可以指定傳入 一對一關聯定義的時候還支持額外的方法，包括： 方法名|描述 ---|--- bind|綁定關聯屬性到父模型 joinType|JOIN方式查詢的JOIN方式，默認為`INNER` >[danger] 如果使用了JOIN方式的關聯查詢方式，你可以在額外的查詢條件中使用關聯對象名（不含命名空間）作為表的別名。 ### 關聯查詢 定義好關聯之后，就可以使用下面的方法獲取關聯數據： ~~~ $user = User::find(1); // 輸出Profile關聯模型的email屬性 echo $user->profile->email; ~~~ 默認情況下， 我們使用的是`user_id` 作為外鍵關聯，如果不是的話則需要在關聯定義的時候指定，例如： ~~~ <?php namespace app\model; use think\Model; class User extends Model { public function profile() { return $this->hasOne(Profile::class, 'uid'); } } ~~~ >[danger] 有一點需要注意的是，關聯方法的命名規范是駝峰法，而關聯屬性則一般是小寫+下劃線的方式，系統在獲取的時候會自動轉換對應，讀取`user_profile`關聯屬性則對應的關聯方法應該是`userProfile`。 ### 根據關聯數據查詢 可以根據關聯條件來查詢當前模型對象數據，例如： ~~~ // 查詢用戶昵稱是think的用戶 // 注意第一個參數是關聯方法名（不是關聯模型名） $users = User::hasWhere('profile', ['nickname'=>'think'])->select(); // 可以使用閉包查詢 $users = User::hasWhere('profile', function(Query $query) { $query->where('nickname', 'like', 'think%'); })->select(); ~~~ ### 預載入查詢 可以使用預載入查詢解決典型的`N+1`查詢問題，使用： ~~~ $users = User::with('profile')->select(); foreach ($users as $user) { echo $user->profile->name; } ~~~ 上面的代碼使用的是`IN`查詢，只會產生2條SQL查詢。 如果要對關聯模型進行約束，可以使用閉包的方式。 ~~~ $users = User::with(['profile' => function(Query $query) { $query->field('id,user_id,name,email'); }])->select(); foreach ($users as $user) { echo $user->profile->name; } ~~~ `with`方法可以傳入數組，表示同時對多個關聯模型（支持不同的關聯類型）進行預載入查詢。 ~~~ $users = User::with(['profile','book'])->select(); foreach ($users as $user) { echo $user->profile->name; foreach($user->book as $book) { echo $book->name; } } ~~~ 如果需要使用`JOIN`方式的查詢，直接使用`withJoin`方法，如下： ~~~ $users = User::withJoin('profile')->select(); foreach ($users as $user) { echo $user->profile->name; } ~~~ `withJoin`方法默認使用的是`INNER JOIN`方式，如果需要使用其它的，可以改成 ~~~ $users = User::withJoin('profile', 'LEFT')->select(); foreach ($users as $user) { echo $user->profile->name; } ~~~ 需要注意的是`withJoin`方式不支持嵌套關聯，通常你可以直接傳入多個需要關聯的模型。 如果需要約束關聯字段，可以使用下面的簡便方法。 ~~~ $users = User::withJoin([ 'profile' => ['user_id', 'name', 'email'] ])->select(); foreach ($users as $user) { echo $user->profile->name; } ~~~ 特別注意的是 `withJoin` 不支持通過 `alias` 方法指定別名。因此如果你需要指定別名查詢的時候，ORM 會自動設定別名。比如我們有表 `user` 和表 `user_profile`，我們也分別定義了 模型 `User` 和 模型 `UserProfile` ，在通過如下的查詢時： ~~~ $users = User::withJoin([ 'profile' => function (Query $query) { $query->where('profile.is_delete', 1); }])->where('user.is_delete', 1)->select(); ~~~ 我們就可以通過，模型名的小寫來指定別名，比如 模型名叫 `User` 則別名為 `user`， 模型名叫 `UserData` 則別名為 `user_data`。 而通過 `withJoin` 關聯的表的別名，就是 我們在使用 `withJoin` 的時候指定的key，比如本例子就是 `profile`。 ### 關聯保存 ~~~ $user = User::find(1); // 如果還沒有關聯數據 則進行新增 $user->profile()->save(['email' => 'thinkphp']); ~~~ 系統會自動把當前模型的主鍵傳入`Profile`模型。 和新增一樣使用`save`方法進行更新關聯數據。 ~~~ $user = User::find(1); $user->profile->email = 'thinkphp'; $user->profile->save(); // 或者 $user->profile->save(['email' => 'thinkphp']); ~~~ ### 定義相對關聯 我們可以在`Profile`模型中定義一個相對的關聯關系，例如： ~~~ <?php namespace app\model; use think\Model; class Profile extends Model { public function user() { return $this->belongsTo(User::class); } } ~~~ `belongsTo`的參數包括： >[info] ### belongsTo('關聯模型','外鍵', '關聯主鍵'); 除了關聯模型外，其它參數都是可選。 * **關聯模型**（必須）：關聯模型類名 * **外鍵**：當前模型外鍵，默認的外鍵名規則是關聯模型名+`_id` * **關聯主鍵**：關聯模型主鍵，一般會自動獲取也可以指定傳入 默認的關聯外鍵是`user_id`，如果不是，需要在第二個參數定義 ~~~ <?php namespace app\model; use think\Model; class Profile extends Model { public function user() { return $this->belongsTo(User::class, 'uid'); } } ~~~ 我們就可以根據檔案資料來獲取用戶模型的信息 ~~~ $profile = Profile::find(1); // 輸出User關聯模型的屬性 echo $profile->user->account; ~~~ ## 綁定屬性到父模型 可以在定義關聯的時候使用`bind`方法綁定屬性到父模型，例如： ~~~ <?php namespace app\model; use think\Model; class User extends Model { public function profile() { return $this->hasOne(Profile::class, 'uid')->bind(['nickname', 'email']); } } ~~~ 或者指定綁定屬性別名 ~~~ <?php namespace app\model; use think\Model; class User extends Model { public function profile() { return $this->hasOne(Profile::class, 'uid')->bind([ 'email', 'truename' => 'nickname', ]); } } ~~~ 然后使用關聯預載入查詢的時候，可以使用 ~~~ $user = User::with('profile')->find(1); // 直接輸出Profile關聯模型的綁定屬性 echo $user->email; echo $user->truename; ~~~ 綁定關聯模型的屬性支持讀取器。 > 如果不是預載入查詢，請使用模型的`appendRelationAttr`方法追加屬性。 也可以使用動態綁定關聯屬性，可以使用 ~~~ $user = User::find(1)->bindAttr('profile',['email','nickname']); // 輸出Profile關聯模型的email屬性 echo $user->email; echo $user->nickname; ~~~ 同樣支持指定屬性別名 ~~~ $user = User::find(1)->bindAttr('profile',[ 'email', 'truename' => 'nickname', ]); // 輸出Profile關聯模型的email屬性 echo $user->email; echo $user->truename; ~~~ ## 關聯自動寫入 我們可以使用`together`方法更方便的進行關聯自動寫入操作。 寫入 ~~~php $blog = new Blog; $blog->name = 'thinkphp'; $blog->title = 'ThinkPHP5關聯實例'; $content = new Content; $content->data = '實例內容'; $blog->content = $content; $blog->together(['content'])->save(); ~~~ 如果綁定了子模型的屬性到當前模型，可以指定子模型的屬性 ~~~php $blog = new Blog; $blog->name = 'thinkphp'; $blog->title = 'ThinkPHP5關聯實例'; $blog->content = '實例內容'; // title和content是子模型的屬性 $blog->together(['content' => ['title', 'content']])->save(); ~~~ 更新 ~~~php // 查詢 $blog = Blog::find(1); $blog->title = '更改標題'; $blog->content->data = '更新內容'; // 更新當前模型及關聯模型 $blog->together(['content'])->save(); ~~~ 刪除 ~~~ // 查詢 $blog = Blog::with('content')->find(1); // 刪除當前及關聯模型 $blog->together(['content'])->delete(); ~~~