Laravelのリレーションを使った検索条件の書き方（whereHas）

1. 基本的なwhereHasの使い方

1. 基本的なwhereHasの使い方

例えば、PostモデルがCommentモデルと1対多のリレーションを持っている場合、コメントがある投稿だけを取得するには以下のように書きます。

$posts = Post::whereHas('comments')->get();

このコードでは、commentsリレーションが存在する投稿のみ取得されます。SQLで言うと、JOINとWHERE EXISTSを組み合わせた検索です。

2. 条件付きでリレーションを検索する

2. 条件付きでリレーションを検索する

さらに、リレーションに条件を付けたい場合は、クロージャ（無名関数）を使います。例えば、承認済みのコメントがある投稿だけを取得する場合は次のように書きます。

$posts = Post::whereHas('comments', function ($query) {
    $query->where('approved', true);
})->get();

ここでは、コメントがapproved = trueのものだけ存在する投稿を検索しています。

3. 複数リレーションやネストした条件

3. 複数リレーションやネストした条件

リレーションがさらに別のリレーションを持っている場合も、ネストして検索できます。例えば、投稿のコメントに対してユーザーの条件を付けたい場合です。

$posts = Post::whereHas('comments.user', function ($query) {
    $query->where('active', true);
})->get();

このように書くと、アクティブなユーザーが書いたコメントがある投稿のみ取得できます。

4. whereDoesntHaveで存在しないリレーションを検索

4. whereDoesntHaveで存在しないリレーションを検索

逆に、リレーションが存在しないものを検索したい場合はwhereDoesntHaveを使います。

$posts = Post::whereDoesntHave('comments')->get();

コメントが一つもない投稿だけを取得することができます。これは「まだコメントがついていない投稿」を探すときに便利です。

5. 注意点とポイント

5. 注意点とポイント

whereHasは非常に便利ですが、使いすぎるとSQLが複雑になりパフォーマンスに影響することがあります。ポイントとしては：

• リレーションの条件はできるだけ絞る。
• 大量データのときは、必要なカラムだけ取得する。
• Eager Loading（with）と組み合わせてN+1問題を回避する。

これらを意識すると、リレーション検索でも効率よくデータを取得できます。

まとめ

まとめ

whereHasを使ったリレーション検索の振り返り

この記事では、LaravelのEloquentにおけるリレーション検索の中でも、特に使用頻度が高いwhereHasの使い方について学んできました。通常のwhereでは、自分自身のテーブルのカラムしか条件にできませんが、whereHasを使うことで、関連する別テーブルの存在や条件をもとに検索できるようになります。 投稿とコメント、ユーザーと投稿など、実際のWebアプリケーションでは複数のテーブルが関連し合う構造が一般的です。その中で「コメントがある投稿だけを表示したい」「特定の条件を満たすユーザーに紐づくデータだけを取得したい」といった要件は非常に多く、whereHasはそうした場面で大きな力を発揮します。

条件付きリレーション検索の重要性

whereHasの基本的な使い方では、単にリレーションが存在するかどうかを条件にしましたが、クロージャを使うことで、さらに細かい条件指定が可能になります。承認済みコメントがある投稿や、アクティブなユーザーが関係しているデータなど、実務で求められる検索条件を自然な形で表現できる点がEloquentの魅力です。 また、リレーションをネストして条件を指定できるため、複雑なデータ構造であっても、読みやすいコードを保ったまま検索処理を記述できます。SQLを直接書かなくても、意図が伝わるコードになることは、保守性の面でも大きなメリットです。

サンプルプログラムで理解を深める

ここで、whereHasを使った検索処理の代表的な例を改めて確認しておきましょう。記事内と同じ形式で、リレーションの存在と条件を組み合わせたコード例です。

$posts = Post::whereHas('comments', function ($query) {
    $query->where('approved', true);
})->get();

このコードでは、「承認済みのコメントを一つ以上持つ投稿」を取得しています。whereHasの中に書いた条件は、リレーション先のテーブルに対して適用されるため、直感的に条件を組み立てられるのが特徴です。さらに、whereDoesntHaveを使えば、リレーションが存在しないデータだけを取得することもでき、未対応データや未登録データの抽出にも活用できます。

パフォーマンスを意識した使い方

whereHasは非常に便利な一方で、内部的にはサブクエリや結合を伴うため、データ量が多い場合は注意が必要です。必要以上に多くのリレーションをネストしたり、条件を複雑にしすぎたりすると、処理速度に影響が出ることもあります。 そのため、検索条件はできるだけ明確にし、不要なカラムを取得しないことや、Eager Loadingを適切に使うことが重要です。これらを意識することで、読みやすさとパフォーマンスの両立が可能になります。