Eloquentのリレーション正しく理解する 〜with()を使ったのにEagerロードされない！？

PHP Conference Japan 2025のLT登壇資料です。

Transcript

1. Eloquentのリレーションを 正しく理解する 〜with()を使ったのにEagerロードされない！？ 2025/06/28　PHP Conference Japan 2025 sito
2. はじめに 2
3. はじめに 3 本日の登壇資料 • X（@ef_sito）の固定ツイートにリンクしてあります ◦ （ついでにフォローしていただけると嬉しいです） • Forteeにもあります
4. 本日のテーマ 4 Eloquentのリレーションを 正しく理解する
5. 本日のテーマ 5 Eloquentのリレーションを 正しく理解する
6. きっかけ 6
7. 日次で契約データ全件を処理するバッチ • 主テーブル：約320万件（2025/06現在） • リレーション：たくさん 今回の主役 7
8. 実行時間が伸びてきている 8 【前提】絶対に23時間以内に完了する必要がある
9. 実行時間が伸びてきている 9 【前提】絶対に23時間以内に完了する必要がある 22時間 １ヶ月
10. 実行時間が伸びてきている 10 【前提】絶対に23時間以内に完了する必要がある 22時間 １ヶ月 😰

11. • 大きな負荷がかかっているクエリを特定 ◦ RDS Performance Insights を利用 調査の結果 11
12. • 大きな負荷がかかっているクエリを特定 ◦ RDS Performance Insights を利用 • N+1問題の発生を確認 調査の結果 12
13. リレーションを理解する 13
14. N+1問題を解消するには？ 14
15. N+1問題を解消するには？ 15 → Eagerロードすれば良い！ ※｢N+1問題｣｢Eagerロード｣についてはスライド末尾の補足資料を参照ください 　（時間の都合上LTでは省略します）
16. 16 // クエリ（※説明のため大幅に簡略化しています） $contracts = Contract::all(); foreach ($contracts as $contract) { $paymentInfo = $contract->paymentInfo()->first(); } // リレーション定義 class Contract extends Model { public function paymentInfo() { return $this->hasOne(PaymentInfo::class); } } 改修 Before
17. // クエリ（※説明のため大幅に簡略化しています） $contracts = Contract::with("paymentInfo")->get(); foreach ($contracts as $contract) { $paymentInfo = $contract->paymentInfo()->first(); } 17 class Contract extends Model { public function paymentInfo() { return $this->hasOne(PaymentInfo::class); } } 改修 After // リレーション定義 class Contract extends Model { public function paymentInfo() { return $this->hasOne(PaymentInfo::class); } }
18. Eloquentでは with() を使うだけで 簡単にEagerロードを実装可能！ このように 18
19. Eloquentでは with() を使うだけで 簡単にEagerロードを実装可能！ このように 19 勝ったわ！風呂入ってくる！
20. ところが…
 
 20
21. ところが…
 
 N+1問題が解消しない （当然パフォーマンスも全く改善されない） 21
22. ところが…
 
 N+1問題が解消しない （当然パフォーマンスも全く改善されない） 22 😰😰😰

23. 原因探し あらためてコードを見てみる 23 $contracts = Contract::with("paymentInfo")->get(); foreach ($contracts as $contract) { $paymentInfo = $contract->paymentInfo()->first(); } 原因は…
24. 原因探し あらためてコードを見てみる 24 $contracts = Contract::with("paymentInfo")->get(); foreach ($contracts as $contract) { $paymentInfo = $contract->paymentInfo()->first(); } 原因は…
25. リレーションを "正しく"理解する
 25
26. ２種類のリレーション • $post->comments() … リレーションメソッド • $post->comments … 動的プロパティ 26
27. ２種類のリレーション • $post->comments() … リレーションメソッド • $post->comments … 動的プロパティ ◯ Eagerロードを適用するには「動的プロパティ」を 　 使用する必要がある 27
28. リレーションメソッド　$contract->paymentInfo() 戻り値はリレーションオブジェクト • クエリビルダとして機能する • 取得時は get() や first() などにチェーンする 28
29. リレーションメソッド　$contract->paymentInfo() 戻り値はリレーションオブジェクト • クエリビルダとして機能する • 取得時は get() や first() などにチェーンする → 呼び出すたびに新しいクエリを発行する 29
30. リレーションメソッド 具体例 30 $contract = Contract::find(1); $contract->$paymentInfo()->first(); $contract->$paymentInfo()->first(); $contract->$paymentInfo()->first();
31. リレーションメソッド 具体例 31 $contract = Contract::find(1); $contract->$paymentInfo()->first(); $contract->$paymentInfo()->first(); $contract->$paymentInfo()->first(); DBアクセス DBアクセス DBアクセス
32. 動的プロパティ　$contract->paymentInfo 戻り値は Eloquent Collection または Model • get() や first() をチェーンせず取得可能 取得結果をキャッシュする 32
33. 動的プロパティ　$contract->paymentInfo 戻り値は Eloquent Collection または Model • get() や first() をチェーンせず取得可能 取得結果をキャッシュする → 2回目以降の呼び出しではクエリが発行されない 33
34. 動的プロパティ 具体例 34 $contract = Contract::find(1); $contract->$paymentInfo; $contract->$paymentInfo; $contract->$paymentInfo;
35. 動的プロパティ 具体例 35 $contract = Contract::find(1); $contract->$paymentInfo; $contract->$paymentInfo; $contract->$paymentInfo; DBアクセス
36. 動的プロパティ 具体例 36 $contract = Contract::find(1); $contract->$paymentInfo; $contract->$paymentInfo; $contract->$paymentInfo; DBアクセス キャッシュから読み出し キャッシュから読み出し
37. 動的プロパティ（少し深堀り） 1. 動的プロパティにアクセス 2. __get() マジックメソッドが呼ばれる 3. キャッシュの有無を確認し、あればそれを返す 4. 無ければリレーションメソッドを呼び出す 5. getResults() した結果をキャッシュし、これを返す 37 ※各ステップに関する説明はスライド末尾の補足資料を参照ください 　（時間の都合上LTでは省略します）
38. 動的プロパティ（少し深堀り） 1. 動的プロパティにアクセス 2. __get() マジックメソッドが呼ばれる 3. キャッシュの有無を確認し、あればそれを返す 4. 無ければリレーションメソッドを呼び出す 5. getResults() した結果をキャッシュし、これを返す 38 ※各ステップに関する説明はスライド末尾の補足資料を参照ください 　（時間の都合上LTでは省略します）
39. $contracts = Contract::with("paymentInfo")->get(); foreach ($contracts as $contract) { $paymentInfo = $contract->paymentInfo()->first(); } 再改修 Eagerロードしたいので、動的プロパティに書き換える 39 Before
40. After 再改修 Eagerロードしたいので、動的プロパティに書き換える 40 $contracts = Contract::with("paymentInfo")->get(); foreach ($contracts as $contract) { $paymentInfo = $contract->paymentInfo; }
41. 結果 41 実行時間が22時間→
42. 実行時間が22時間→6時間半に 結果 42 １ヶ月
 (h)
43. まとめ 43
44. まとめ • 今回の失敗は、Eloquentについて"中途半端に"理解して いたことが原因 44
45. まとめ • 今回の失敗は、Eloquentについて"中途半端に"理解して いたことが原因 → "正しく"理解することが重要 45
46. 補足資料 46
47. 補足：Eagerロードの副作用 むやみやたらにEagerロードすればいいわけではない • やりすぎるとどうなるか？ 47
48. 補足：Eagerロードの副作用 むやみやたらにEagerロードすればいいわけではない • やりすぎるとどうなるか？ 48 Fatal error: Allowed memory size of ****** bytes exhausted (tried to allocate ***** bytes) in ...
49. 「1つのクエリで取得したデータをもとに、さらにN回のクエリが発行さ れ、結果として合計でN+1回のクエリが実行される状況」 補足：N+1問題とは（ざっくり） 49 class Post extends Model { public function comments() { return $this->hasMany(Comment::class); } } $posts = Post::all(); foreach ($posts as $post) { echo $post->comments; } SELECT * FROM posts;　　　　　　　　　　　　　　　 1回 SELECT * FROM comments WHERE post_id = ?;　　　　N回（postの件数分） N+1 postが100件あったら、(この4行で)クエリが101回実行される
50. $posts = Post::with("comments") ->get(); foreach ($posts as $post) { echo $post->comments; } 「親のモデルに対するクエリと同時にリレーションデータも取得する」 補足：Eagerロードとは（ざっくり） SELECT * FROM posts;　 SELECT * FROM comments WHERE post_id IN (?, ?, ... → post が何件あろうと、クエリ2回で取得できる 50 対して、リレーションデータへのアクセス時にクエリを発行するものを「Lazyロード」と いう。 N+1問題の原因になるが、メモリ消費を抑えられるなどのメリットもある。
51. 補足：動的プロパティ（少し深堀り） 1. 動的プロパティにアクセス ◦ 例：$contract->paymentInfo 51
52. 補足：動的プロパティ（少し深堀り） 1. 動的プロパティにアクセス 2. __get() マジックメソッドが呼ばれる ◦ Illuminate\Database\Eloquent\Model 52
53. 補足：動的プロパティ（少し深堀り） __get() マジックメソッドが呼ばれる 53 https://github.com/illuminate/database /blob/12.x/Eloquent/Model.php#L2376- L2385 $this->getAttribute($key) ※呼び出し先は 　Concerns\HasAttributes Trait
54. 補足：動的プロパティ（少し深堀り） 1. 動的プロパティにアクセス 2. __get() マジックメソッドが呼ばれる 3. キャッシュの有無を確認し、あればそれを返す ◦ Illuminate\Database\Eloquent\Concerns\HasAttributes 54
55. 補足：動的プロパティ（少し深堀り） キャッシュの有無を確認し、あればそれを返す 55 https://github.com/illuminate /database/blob/12.x/Eloquen t/Concerns/HasAttributes.ph p#L548-L555 return $this->relations[$key]
56. 補足：動的プロパティ（少し深堀り） 1. 動的プロパティにアクセス 2. __get() マジックメソッドが呼ばれる 3. キャッシュの有無を確認し、あればそれを返す 4. 無ければリレーションメソッドを呼び出す 5. getResults() した結果をキャッシュし、これを返す ◦ Illuminate\Database\Eloquent\Concerns\HasAttributes ◦ Illuminate\Database\Eloquent\Concerns\HasRelationships 56
57. 補足：動的プロパティ（少し深堀り） キャッシュが無ければリレーションメソッドを呼び出す 57 https://github.com/illuminate/databa se/blob/12.x/Eloquent/Concerns/Has Attributes.php#L610-L620 $relation = $this->method();
58. 補足：動的プロパティ（少し深堀り） 戻り値（リレーションオブジェクト）に対して getResults() 58 https://github.com/illuminate/database/blob/12.x/ Eloquent/Concerns/HasAttributes.php#L634-L636 $relation->getResults() ※getResults()：リレーションの種類に応じて Model／Collection を返す
59. 補足：動的プロパティ（少し深堀り） 結果をキャッシュし、これを返す 59 https://github.com/illuminate/database/ blob/12.x/Eloquent/Concerns/HasRelati onships.php#L1087-L1101 $this->relations[$relation] = $value return $this