## 關聯預載入 關聯查詢的預查詢載入功能，主要解決了`N+1`次查詢的問題，例如下面的查詢如果有3個記錄，會執行4次查詢： ~~~ $list = User::select([1,2,3]); foreach($list as $user){ // 獲取用戶關聯的profile模型數據 dump($user->profile); } ~~~ 如果使用關聯預查詢功能，就可以變成2次查詢（對于一對一關聯來說，如果使用`withJoin`方式只有一次查詢），有效提高性能。 ~~~ $list = User::with(['profile'])->select([1,2,3]); foreach($list as $user){ // 獲取用戶關聯的profile模型數據 dump($user->profile); } ~~~ 支持預載入多個關聯，例如： ~~~ $list = User::with(['profile', 'book'])->select([1,2,3]); ~~~ >[danger] `with`方法只能調用一次，請不要多次調用，如果需要對多個關聯模型預載入使用數組即可。 也可以支持嵌套預載入，例如： ~~~ $list = User::with(['profile.phone'])->select([1,2,3]); foreach($list as $user){ // 獲取用戶關聯的phone模型 dump($user->profile->phone); } ~~~ 支持使用數組方式定義嵌套預載入，例如下面的預載入要同時獲取用戶的`Profile`關聯模型的`Phone`、`Job`和`Img`子關聯模型數據： ~~~ $list = User::with(['profile'=>['phone','job','img']])->select([1,2,3]); foreach($list as $user){ // 獲取用戶關聯 dump($user->profile->phone); dump($user->profile->job); dump($user->profile->img); } ~~~ 如果要指定屬性查詢，可以使用： ~~~ $list = User::field('id,name')->with(['profile' => function($query){ $query->field('user_id,email,phone'); }])->select([1,2,3]); foreach($list as $user){ // 獲取用戶關聯的profile模型數據 dump($user->profile); } ~~~ >[danger] 記得指定屬性的時候一定要包含關聯鍵。 對于一對多關聯來說，如果需要設置返回的關聯數據數量，使用`withLimit`方法（`limit`方法無效）。 ``` Article::with(['comments' => function(Relation $query) { $query->order('create_time', 'desc')->withLimit(3); })->select(); ``` >[danger] 注意這里的類型約束必須使用 `think\model\Relation`，因為`withLimit`方法是關聯類才有的方法 關聯預載入名稱是關聯方法名，支持傳入方法名的小寫和下劃線定義方式，例如如果關聯方法名是`userProfile`和`userBook`的話： ~~~ $list = User::with(['userProfile','userBook'])->select([1,2,3]); ~~~ 和下面的方法都可以查詢到關聯數據： ~~~ $list = User::with(['user_profile','user_book'])->select([1,2,3]); ~~~ 區別在于你獲取關聯數據的時候必須和傳入的關聯名稱保持一致。 ~~~ $user = User::with(['userProfile'])->find(1); dump($user->userProfile); $user = User::with(['user_profile'])->find(1); dump($user->user_profile); ~~~ 一對一關聯預載入支持兩種方式：`JOIN`方式（一次查詢）和`IN`方式（兩次查詢，默認方式），如果要使用`JOIN`方式關聯預載入，可以使用`withJoin`方法。 ~~~ $list = User::withJoin(['profile' => function(Relation $query){ $query->withField('truename,email'); }])->select([1,2,3]); ~~~ ## 延遲預載入 有些情況下，需要根據查詢出來的數據來決定是否需要使用關聯預載入，當然關聯查詢本身就能解決這個問題，因為關聯查詢是惰性的，不過用預載入的理由也很明顯，性能具有優勢。 延遲預載入僅針對多個數據的查詢，因為單個數據的查詢用延遲預載入和關聯惰性查詢沒有任何區別，所以不需要使用延遲預載入。 如果你的數據集查詢返回的是數據集對象，可以使用調用數據集對象的`load`實現延遲預載入： ~~~ // 查詢數據集 $list = User::select([1,2,3]); // 延遲預載入 $list->load(['cards']); foreach($list as $user){ // 獲取用戶關聯的card模型數據 dump($user->cards); } ~~~ ## 關聯預載入緩存 關聯預載入可以支持查詢緩存，例如： ~~~ $list = User::with(['profile'])->withCache(30)->select([1,2,3]); ~~~ 表示對關聯數據緩存30秒。 如果你有多個關聯數據，也可以僅僅緩存部分關聯 ~~~ $list = User::with(['profile', 'book'])->withCache(['profile'],30)->select([1,2,3]); ~~~ 對于延遲預載入查詢的話，可以在第二個參數傳入緩存參數。 ``` // 查詢數據集 $list = User::select([1,2,3]); // 延遲預載入 $list->load(['cards'], 30); ```