Laravelで複数条件の絞り込みを行う方法（チェーン記法）完全ガイド

1. 複数条件を使った基本の絞り込み（AND検索）

1. 複数条件を使った基本の絞り込み（AND検索）

Webサイトの検索機能で最もよく使われるのが、複数の条件をすべて満たすデータを探す「AND検索」です。LaravelのEloquent（エロクアント）では、メソッドを数珠つなぎにするチェーン記法を使うことで、驚くほど直感的にこの機能を実装できます。

例えば、会員サイトの管理画面で「名前が田中さん」かつ「年齢が20歳以上」という2つの条件に一致するユーザーを抽出したい場合、コードは以下のようになります。

use App\Models\User;

// メソッドを「->」でつなげて条件を追加していく
$users = User::where('name', '田中') // 条件1：名前が田中
             ->where('age', '>=', 20) // 条件2：20歳以上（比較演算子を使用）
             ->get(); // 条件に一致するデータをすべて取得

このコードを実行すると、内部では「名前が田中 AND 年齢が20以上」というSQL文が自動的に生成されます。プログラミング未経験の方でも、「where」を並べるだけで「かつ（AND）」という意味になると覚えれば、すぐに使いこなせるようになります。

配列を使ったスマートな書き方

条件が「＝（等しい）」ものばかりであれば、次のように配列を使ってまとめて指定することも可能です。コードがスッキリして読みやすくなります。

// 名前が田中、かつ性別が男性のユーザーを取得
$users = User::where([
    ['name', '田中'],
    ['gender', 'male'],
])->get();

実行結果のイメージ

このプログラムを実行して、条件に一致するデータが見つかった場合、以下のような形式でデータが取得されます。

[
    {"id": 1, "name": "田中", "age": 25, "gender": "male"},
    {"id": 5, "name": "田中", "age": 30, "gender": "male"}
]

このように、whereを重ねて書くことで、膨大なデータの中から必要な情報だけをピンポイントで絞り込むことができるようになります。

2. OR条件を使った複数条件の検索

2. OR条件を使った複数条件の検索

場合によっては「名前が田中または名前が鈴木」のように、どちらかの条件に合うデータを取得したいことがあります。この場合はorWhereを使います。

$users = User::where('name', '田中')
             ->orWhere('name', '鈴木')
             ->get();

このように書くことで、田中または鈴木のどちらかの名前を持つユーザーが取得されます。

3. 条件をグループ化して複雑な検索を行う

3. 条件をグループ化して複雑な検索を行う

さらに複雑な条件の場合、クロージャ（無名関数）を使って条件をグループ化できます。例えば「年齢が20歳以上で、名前が田中または鈴木」のユーザーを取得する場合は次のように書きます。

$users = User::where('age', '>=', 20)
             ->where(function($query){
                 $query->where('name', '田中')
                       ->orWhere('name', '鈴木');
             })
             ->get();

この書き方により、条件をグループ化して論理的に正しい検索ができます。

4. チェーン記法の便利さ

4. チェーン記法の便利さ

チェーン記法を使うと、複数のwhereやorWhere、orderByなどを連続でつなげることができます。これにより、コードがシンプルで見やすくなり、複雑な検索条件も整理しやすくなります。

例えば「20歳以上のユーザーで名前が田中または鈴木を年齢順で並べたい」ときも、次のように書けます。

$users = User::where('age', '>=', 20)
             ->where(function($query){
                 $query->where('name', '田中')
                       ->orWhere('name', '鈴木');
             })
             ->orderBy('age', 'asc')
             ->get();

5. 初心者でも押さえておきたいポイント

5. 初心者でも押さえておきたいポイント

複数条件の絞り込みは、ユーザー検索や商品検索、ブログ記事のフィルターなどで頻繁に使います。Eloquentのチェーン記法を理解しておくことで、条件追加や順序指定が簡単になります。

最初はAND条件やOR条件の基本から始め、慣れてきたらクロージャを使った複雑な条件グループ化にも挑戦すると良いでしょう。こうした検索方法を覚えることで、より高度なデータ操作が可能になり、実務でも役立ちます。

また、メソッドチェーンでコードをつなげることにより、SQLを書かなくても直感的にデータベース検索ができるため、初心者でも扱いやすいのがEloquentの強みです。

まとめ

まとめ

ここまで、LaravelのEloquent（エロクアント）を活用した複数条件の絞り込み方法について詳しく解説してきました。Webアプリケーション開発において、データベースから特定の条件に合致するデータを取り出す作業は避けて通れません。特にユーザー検索や商品一覧のフィルタリング、管理画面でのデータ抽出など、実務における活用シーンは多岐にわたります。

Laravelのチェーン記法が強力な理由

Laravelの最大の特徴の一つは、SQLを直接記述することなく、PHPのメソッドをつなげていく「メソッドチェーン（チェーン記法）」で直感的にクエリを構築できる点にあります。この手法を用いることで、ソースコードの可読性が飛躍的に向上し、後からコードを見返した際にも「どのような条件で検索しているのか」が一目で理解できるようになります。

例えば、複数の条件を順番に追加していくコードは、まるで英文を読んでいるかのような自然な流れになります。

// シンプルな複数条件（AND検索）の例
$results = User::where('status', 'active')
               ->where('role', 'admin')
               ->where('login_count', '>', 10)
               ->get();

上記のコードでは、「ステータスが有効」かつ「役割が管理者」かつ「ログイン回数が10回より多い」という3つの条件をANDで結合しています。これを素のSQLで書こうとすると、文字列の連結やバインド変数の考慮など、記述が煩雑になりがちですが、Laravelならこれだけで完結します。

さらに高度な検索テクニック：動的な絞り込み

実際のプロジェクトでは、検索フォームから送られてきた値があるときだけ条件を追加したい、といった動的な絞り込みが必要になることが多々あります。その場合、whenメソッドをチェーンに組み込むと、さらにスマートに記述できます。

$keyword = $request->input('keyword');

$users = User::where('is_active', true)
             ->when($keyword, function ($query, $keyword) {
                 return $query->where('name', 'like', "%{$keyword}%");
             })
             ->orderBy('created_at', 'desc')
             ->get();

この記述方法を覚えておくと、検索キーワードが入力されているときだけwhere句を追加するといった柔軟な対応が可能になります。if文を多用してクエリビルダを分割して書くよりも、メソッドチェーンの中で完結させる方が、Laravelらしい洗練されたコードと言えるでしょう。

複雑な論理構造とクロージャの活用

本記事の第3章でも触れましたが、where句の中にクロージャを渡すことで、SQLにおける「括弧 ()」で囲った条件グループを作ることができます。これは、AND条件とOR条件が混在する場合に、優先順位を明確にするために不可欠なテクニックです。

例えば、「退会していないユーザーの中で、(名前が"佐藤" または メールアドレスに"example.com"を含む)」という条件を考えた場合、以下のようなプログラムになります。

$users = User::where('deleted_at', null)
             ->where(function($query) {
                 $query->where('name', '佐藤')
                       ->orWhere('email', 'like', '%example.com%');
             })
             ->get();

このように、クロージャを使うことで、複雑な条件分岐も構造的に、かつ安全に構築できるのがEloquentの素晴らしい点です。

データベース操作のベストプラクティス

Laravelで複数条件の絞り込みを行う際は、以下のポイントを意識すると、より保守性の高いコードになります。

• クエリスコープの活用： 頻繁に使う絞り込み条件（例：有効なユーザーのみなど）は、Modelクラス内にscopeActiveといった名前で定義しておくと、チェーンの中で->active()と呼び出せるようになり、再利用性が高まります。
• ページネーションとの組み合わせ： 取得データが多い場合は、get()の代わりにpaginate(15)などを使うことで、簡単にページめくり機能を実装できます。
• デバッグの習慣： 意図した通りに動かない場合は、チェーンの最後に->toSql()を付けて、実際に生成されているSQLを確認してみましょう。

Laravelの習得において、この「チェーン記法によるデータ操作」をマスターすることは、開発効率を劇的に向上させるための大きな一歩です。最初は基本のwhereから始め、徐々にorWhereやクロージャ、そしてwhenやクエリスコープへとステップアップしていきましょう。

[
  {
    "id": 1,
    "name": "田中 太郎",
    "age": 25,
    "email": "tanaka@example.com"
  },
  {
    "id": 5,
    "name": "鈴木 一郎",
    "age": 30,
    "email": "suzuki@example.com"
  }
]