Eloquentのリレーションを正しく理解する 〜withメソッド使ったのにEagerロードされない!?〜 by sito

PHP Conference Japan 2025
LT(5分)

Eloquentのリレーションを正しく理解する 〜withメソッド使ったのにEagerロードされない!?〜

ef_sito sito ef_sito
1

「パフォーマンス調査をしたら凄まじい数のクエリが発行されていた」という経験、ありませんか?
私自身、重いバッチの調査でRDSのPerformance Insightsを見てひっくり返ったことがあります。

これが有名な「N+1問題」ですが、バッチやCSV出力といった大きめのデータ処理で陥りやすい問題の代表例かと思います。
その一因として、Laravel標準のORMであるEloquentでは、リレーション取得をループすることで意図せず大量のクエリが発行されてしまうことが挙げられます。

一方で対策は比較的簡単で、withメソッドを使用してEagerロードさせることで、リレーションデータも1回のクエリで取得することができます。
しかし、安易に「親データの取得時にwithメソッドを呼び出せば解決」と考えていると、思わぬ罠に嵌まる可能性があります。

本LTでは私の失敗を出発点として、Eagerロードさせる上での注意点からEloquentのリレーションの仕組みまでお話しします。

トピック

  • N+1問題とEagerロード
  • 動的プロパティ($user->posts)とリレーションメソッド($user->posts())