Laravel WHERE句で複数条件を指定する7つの実践的な方法 – パフォーマンスを最適化する実装テクニック

Laravel WHERE句での複数条件指定の基礎知識

WHERE句による複数条件指定の重要性とユースケース

データベースクエリにおいて、複数の条件を組み合わせた検索は非常に一般的な要件です。Laravelでは、エレガントなクエリビルダを使用して、複雑な検索条件を簡潔かつ可読性の高いコードで実装することができます。

以下のような場面で複数条件の指定が必要となります:

  1. ユーザー検索の絞り込み
  • 年齢範囲と性別による検索
  • 特定の役割を持つアクティブユーザーの抽出
   $users = User::where('age', '>=', 20)
                ->where('age', '<=', 30)
                ->where('status', 'active')
                ->get();
  1. 商品検索フィルター
  • 価格帯とカテゴリによる絞り込み
  • 在庫状況と公開状態の確認
   $products = Product::where('category_id', $category)
                     ->where('price', '>=', $minPrice)
                     ->where('stock', '>', 0)
                     ->where('is_published', true)
                     ->get();
  1. データ分析と集計
  • 特定期間のトランザクション集計
  • 条件付きの売上集計
   $sales = Order::where('created_at', '>=', $startDate)
                 ->where('created_at', '<=', $endDate)
                 ->where('status', 'completed')
                 ->sum('amount');

複数条件を扱う際の基本的な考え方

複数条件を実装する際は、以下の原則を念頭に置くことが重要です:

  1. 条件の論理的な組み立て
  • AND条件とOR条件の適切な使い分け
  • 条件の評価順序の考慮
   // 論理的なグループ化の例
   $query = User::where(function($q) {
       $q->where('role', 'admin')
         ->orWhere('role', 'moderator');
   })->where('is_active', true);
  1. パフォーマンスへの配慮
  • インデックスの活用を考慮した条件の順序
  • 不要な条件の排除
   // インデックスを活用できる条件順序
   $users = User::where('status', 'active')  // インデックス列を先に
                ->where('email', 'LIKE', "%{$search}%")  // LIKE検索は後に
                ->get();
  1. 保守性とメンテナンス性
  • 条件のモジュール化
  • 再利用可能なスコープの活用
   // モデルでスコープを定義
   public function scopeActive($query) {
       return $query->where('status', 'active');
   }

   // スコープの使用
   $users = User::active()
                ->where('age', '>=', 18)
                ->get();
  1. セキュリティの考慮
  • ユーザー入力値の適切なバリデーション
  • SQLインジェクション対策
   // 安全な条件指定
   $users = User::where('age', '>=', intval($request->age))
                ->where('status', in_array($request->status, ['active', 'pending']))
                ->get();

これらの基本原則を理解することで、より効率的で保守性の高いクエリを実装することが可能になります。次のセクションでは、これらの原則を踏まえた具体的な実装方法について詳しく解説していきます。

複数条件を指定する7つの実装方法

1. whereメソッドを連結して使用する方法

最も基本的な方法として、whereメソッドを連結する方法があります。この方法は可読性が高く、条件を段階的に追加できる利点があります。

// 基本的な連結
$users = User::where('status', 'active')
             ->where('age', '>=', 20)
             ->where('role', 'member')
             ->get();

// 比較演算子を使用した例
$products = Product::where('price', '>', 1000)
                  ->where('stock', '>=', 10)
                  ->where('category_id', 5)
                  ->get();

メリット

  • コードの可読性が高い
  • 条件の追加・削除が容易
  • デバッグがしやすい

デメリット

  • 条件が多い場合にコードが長くなる
  • 同じカラムに対する複数条件の表現が冗長になることがある

2. 配列を使用したwhere条件の指定方法

複数の条件をまとめて指定する場合、配列を使用する方法が効率的です。

// 配列による条件指定
$conditions = [
    ['status', 'active'],
    ['age', '>=', 20],
    ['role', 'member']
];

$users = User::where($conditions)->get();

// 連想配列を使用した方法
$criteria = [
    'status' => 'active',
    'role' => 'member'
];

$users = User::where($criteria)->get();

メリット

  • コードがコンパクト
  • 条件の動的な生成が容易
  • 条件の一元管理が可能

デメリット

  • 複雑な条件の表現が若干難しい
  • デバッグ時に条件の特定がやや困難

3. whereInメソッドを活用した複数値の検索

特定のカラムに対して複数の値を条件として指定する場合、whereInメソッドが有効です。

// 基本的なwhereInの使用
$users = User::whereIn('role', ['admin', 'moderator', 'editor'])
             ->where('is_active', true)
             ->get();

// サブクエリを使用したwhereIn
$activeUserIds = Activity::where('last_active_at', '>=', now()->subDays(7))
                        ->pluck('user_id');

$users = User::whereIn('id', $activeUserIds)
             ->where('status', 'active')
             ->get();

メリット

  • 複数値の条件指定が簡潔
  • パフォーマンスが最適化されている
  • サブクエリとの組み合わせが容易

デメリット

  • 大量のデータを扱う場合はメモリ使用量に注意が必要

4. クロージャを使用した複雑な条件の実装

より複雑な条件やグループ化された条件を実装する場合、クロージャを使用します。

// 基本的なクロージャの使用
$users = User::where(function($query) {
    $query->where('role', 'admin')
          ->orWhere('role', 'moderator');
})->where('is_active', true)
  ->get();

// ネストされた条件
$orders = Order::where(function($query) use ($startDate, $endDate) {
    $query->where(function($q) use ($startDate) {
        $q->where('created_at', '>=', $startDate)
          ->where('status', 'completed');
    })->orWhere(function($q) use ($endDate) {
        $q->where('created_at', '<=', $endDate)
          ->where('status', 'pending');
    });
})->where('is_deleted', false)
  ->get();

メリット

  • 複雑な条件の論理的なグループ化が可能
  • 高度な条件分岐の実装が可能
  • コードの構造化が容易

デメリット

  • ネストが深くなるとコードの可読性が低下する
  • デバッグが複雑になる可能性がある

5. orWhereによる条件の分岐処理

OR条件を使用して複数の条件パターンを実装する場合、orWhereメソッドを使用します。

// 基本的なorWhereの使用
$users = User::where('status', 'active')
             ->where(function($query) {
                 $query->where('role', 'admin')
                       ->orWhere('role', 'moderator');
             })
             ->get();

// 検索機能での活用例
$search = 'john';
$users = User::where('status', 'active')
             ->where(function($query) use ($search) {
                 $query->where('name', 'LIKE', "%{$search}%")
                       ->orWhere('email', 'LIKE', "%{$search}%")
                       ->orWhere('username', 'LIKE', "%{$search}%");
             })
             ->get();

メリット

  • 柔軟な条件分岐が可能
  • 検索機能の実装に適している
  • 条件のグループ化が直感的

デメリット

  • パフォーマンスに影響を与える可能性がある
  • インデックスの効果が低下する可能性がある

6. whereHasによるリレーション先のデータ検索

リレーション先のデータを条件として使用する場合、whereHasメソッドが効果的です。

// 基本的なwhereHasの使用
$users = User::whereHas('orders', function($query) {
    $query->where('total_amount', '>', 10000)
          ->where('status', 'completed');
})->where('is_active', true)
  ->get();

// 複数のリレーションを組み合わせた例
$posts = Post::whereHas('author', function($query) {
    $query->where('status', 'active');
})->whereHas('comments', function($query) {
    $query->where('created_at', '>=', now()->subDays(7));
})->where('is_published', true)
  ->get();

メリット

  • リレーションを使用した複雑な条件指定が可能
  • Eagerローディングとの相性が良い
  • データの整合性を保ちやすい

デメリット

  • パフォーマンスに注意が必要
  • 適切なインデックス設計が重要

7. スコープを活用した再利用可能な条件設定

頻繁に使用する条件セットをスコープとして定義し、再利用可能にする方法です。

// モデルでのスコープ定義
class User extends Model
{
    public function scopeActive($query)
    {
        return $query->where('status', 'active');
    }

    public function scopeRole($query, $role)
    {
        return $query->where('role', $role);
    }

    public function scopeRecentlyActive($query, $days = 7)
    {
        return $query->where('last_active_at', '>=', now()->subDays($days));
    }
}

// スコープの使用
$users = User::active()
             ->role('admin')
             ->recentlyActive(30)
             ->get();

// 動的なスコープの組み合わせ
$users = User::when($request->has('role'), function($query) use ($request) {
    return $query->role($request->role);
})
->when($request->has('active_days'), function($query) use ($request) {
    return $query->recentlyActive($request->active_days);
})
->get();

メリット

  • コードの再利用性が高い
  • ビジネスロジックの一元管理が可能
  • テストが容易
  • 条件の一貫性を保ちやすい

デメリット

  • スコープの命名と管理が重要
  • 過度な抽象化は避ける必要がある

これらの実装方法は、単独で使用するだけでなく、状況に応じて組み合わせることで、より効果的な実装が可能になります。次のセクションでは、これらの実装方法を使用する際のパフォーマンス最適化について詳しく解説します。

パフォーマンスを考慮した実装のベストプラクティス

インデックスを活用した検索の最適化

複数条件を使用したクエリのパフォーマンスを最適化するには、適切なインデックス設計が不可欠です。

複合インデックスの効果的な設計

// インデックス設計例(マイグレーションファイル)
public function up()
{
    Schema::table('users', function (Blueprint $table) {
        // 頻繁に使用される検索条件の組み合わせに対する複合インデックス
        $table->index(['status', 'role', 'created_at']);

        // 範囲検索とソートを考慮したインデックス
        $table->index(['department_id', 'created_at']);
    });
}

// 効果的なインデックス活用例
$users = User::where('status', 'active')
             ->where('role', 'admin')
             ->where('created_at', '>=', now()->subDays(30))
             ->get();

インデックス設計のベストプラクティス

  1. 選択性の高い順序での定義
   // 良い例:選択性の高い条件から指定
   $query->where('status', 'active')      // 少ない種類の値
        ->where('role', 'admin')         // 中程度の種類
        ->where('created_at', '>', $date); // 範囲検索

   // 避けるべき例:選択性の低い条件から指定
   $query->where('created_at', '>', $date)
        ->where('status', 'active')
        ->where('role', 'admin');
  1. カバリングインデックスの活用
   // カバリングインデックスを活用した効率的なクエリ
   // マイグレーション
   Schema::table('products', function (Blueprint $table) {
       $table->index(['category_id', 'status', 'price', 'name']);
   });

   // クエリ
   $products = Product::select('category_id', 'status', 'price', 'name')
                     ->where('category_id', $categoryId)
                     ->where('status', 'active')
                     ->where('price', '>', 1000)
                     ->get();

N+1問題を防ぐためのEagerローディングの実装

N+1問題は、複数条件を使用する際に特に注意が必要です。適切なEagerローディングを実装することで、パフォーマンスを大幅に改善できます。

// N+1問題が発生するクエリ
$users = User::where('status', 'active')->get();
foreach ($users as $user) {
    // 各ユーザーに対して個別のクエリが発行される
    $posts = $user->posts->where('is_published', true);
}

// Eagerローディングを使用した最適化
$users = User::with(['posts' => function($query) {
    $query->where('is_published', true);
}])->where('status', 'active')
   ->get();

// 複数のリレーションに対するEagerローディング
$orders = Order::with(['customer' => function($query) {
    $query->where('status', 'active');
}, 'products' => function($query) {
    $query->where('stock', '>', 0);
}])->where('status', 'pending')
   ->get();

条件付きEagerローディングの活用

// whenLoadingによる条件付きEagerローディング
$users = User::query()
    ->when($request->with_posts, function($query) {
        $query->with(['posts' => function($query) {
            $query->where('is_published', true);
        }]);
    })
    ->where('status', 'active')
    ->get();

// 動的な関連データのロード
$posts = Post::query()
    ->when($request->includes_comments, function($query) {
        $query->with(['comments' => function($query) {
            $query->latest()->limit(5);
        }]);
    })
    ->when($request->includes_author, function($query) {
        $query->with('author:id,name,email');
    })
    ->where('status', 'published')
    ->get();

クエリビルダのキャッシュ活用術

頻繁に実行される複雑なクエリに対しては、キャッシュを効果的に活用することで、パフォーマンスを向上させることができます。

// 基本的なクエリキャッシュの実装
$users = Cache::remember('active_admin_users', 3600, function() {
    return User::where('status', 'active')
               ->where('role', 'admin')
               ->with('permissions')
               ->get();
});

// タグ付きキャッシュの実装
$products = Cache::tags(['products', 'category_'.$categoryId])
    ->remember('filtered_products_'.$categoryId, 3600, function() use ($categoryId) {
        return Product::where('category_id', $categoryId)
                     ->where('status', 'active')
                     ->where('stock', '>', 0)
                     ->with('category')
                     ->get();
    });

キャッシュ戦略のベストプラクティス

  1. 適切なキャッシュ期間の設定
   // データの更新頻度に応じたキャッシュ期間の設定
   $shortTermCache = Cache::remember('recent_orders', 300, function() {
       return Order::where('created_at', '>=', now()->subHours(1))
                  ->where('status', 'pending')
                  ->get();
   });

   $longTermCache = Cache::remember('product_categories', 86400, function() {
       return Category::where('status', 'active')
                     ->with('subcategories')
                     ->get();
   });
  1. キャッシュの選択的無効化
   // モデルイベントを使用したキャッシュの自動無効化
   class Product extends Model
   {
       protected static function boot()
       {
           parent::boot();

           static::updated(function ($product) {
               Cache::tags(['products', 'category_'.$product->category_id])->flush();
           });
       }
   }
  1. 部分的なキャッシュの実装
   // 頻繁に使用される集計値のキャッシュ
   $statsCache = Cache::remember('product_stats', 3600, function() {
       return [
           'total_active' => Product::where('status', 'active')->count(),
           'low_stock' => Product::where('stock', '<', 10)->count(),
           'out_of_stock' => Product::where('stock', 0)->count()
       ];
   });

これらのパフォーマンス最適化テクニックを適切に組み合わせることで、複数条件を使用するクエリのレスポンスタイムを大幅に改善することができます。次のセクションでは、これらの実装時に注意すべき点とトラブルシューティングについて解説します。

実装時の注意点とトラブルシューティング

よくあるエラーとその解決方法

1. N+1問題の検出と解決

// 問題のあるコード
class OrderController extends Controller
{
    public function index()
    {
        // N+1問題が発生するコード
        $orders = Order::where('status', 'processing')
                      ->get();

        foreach ($orders as $order) {
            $customerName = $order->customer->name;  // 追加のクエリが発生
            $productCount = $order->products->count();  // 追加のクエリが発生
        }
    }
}

// 解決策
class OrderController extends Controller
{
    public function index()
    {
        // Eagerローディングを使用した解決策
        $orders = Order::where('status', 'processing')
                      ->with(['customer:id,name', 'products'])
                      ->get();

        // クエリログでの確認方法
        \DB::enableQueryLog();
        // クエリの実行
        \DB::getQueryLog();
    }
}

2. メモリ使用量の問題

// 問題のあるコード:大量のデータをメモリに読み込む
$users = User::where('status', 'active')->get();  // 全件取得

// 解決策1:チャンク処理の使用
User::where('status', 'active')
    ->chunk(1000, function ($users) {
        foreach ($users as $user) {
            // 処理
        }
    });

// 解決策2:カーソルの使用
foreach (User::where('status', 'active')->cursor() as $user) {
    // 処理
}

// 解決策3:ページネーションの実装
$users = User::where('status', 'active')
             ->paginate(50);

3. パフォーマンス低下の特定と改善

// 問題のあるクエリ
$slowQuery = User::where('name', 'LIKE', '%' . $search . '%')
                 ->orWhere('email', 'LIKE', '%' . $search . '%')
                 ->get();

// 改善策1:インデックスの活用
Schema::table('users', function (Blueprint $table) {
    $table->index(['name', 'email']);
});

// 改善策2:全文検索の使用
$optimizedQuery = User::whereFullText(['name', 'email'], $search)
                     ->get();

// 改善策3:検索条件の最適化
$betterQuery = User::where(function($query) use ($search) {
    $query->where('name', 'LIKE', $search . '%')  // 前方一致に変更
          ->orWhere('email', 'LIKE', $search . '%');
})->get();

セキュリティ対策とバリデーション処理の実装

1. SQLインジェクション対策

// 危険なコード
$rawQuery = "SELECT * FROM users WHERE status = '" . $status . "'";
$users = DB::raw($rawQuery);  // SQLインジェクションの危険性

// 安全な実装
// バインディングを使用
$users = DB::table('users')
           ->where('status', $status)
           ->get();

// プリペアードステートメントの使用
$users = User::whereRaw('status = ?', [$status])
             ->get();

// 値の検証
$validStatus = in_array($status, ['active', 'inactive', 'pending'])
    ? $status
    : 'active';

$users = User::where('status', $validStatus)->get();

2. 入力値のバリデーション

// フォームリクエストの実装
class UserSearchRequest extends FormRequest
{
    public function rules()
    {
        return [
            'status' => 'required|in:active,inactive,pending',
            'age' => 'nullable|integer|min:0|max:150',
            'role_ids' => 'nullable|array',
            'role_ids.*' => 'exists:roles,id'
        ];
    }
}

// コントローラでの使用
class UserController extends Controller
{
    public function search(UserSearchRequest $request)
    {
        $query = User::query();

        if ($request->filled('status')) {
            $query->where('status', $request->status);
        }

        if ($request->filled('age')) {
            $query->where('age', $request->age);
        }

        if ($request->filled('role_ids')) {
            $query->whereIn('role_id', $request->role_ids);
        }

        return $query->get();
    }
}

テストコードの作成とデバッグ方法

1. ユニットテストの実装

class UserQueryTest extends TestCase
{
    use RefreshDatabase;

    /** @test */
    public function it_correctly_filters_users_by_multiple_conditions()
    {
        // テストデータの準備
        User::factory()->count(5)->create(['status' => 'active', 'role' => 'user']);
        User::factory()->count(3)->create(['status' => 'active', 'role' => 'admin']);
        User::factory()->count(2)->create(['status' => 'inactive', 'role' => 'user']);

        // クエリのテスト
        $result = User::where('status', 'active')
                     ->where('role', 'admin')
                     ->get();

        $this->assertCount(3, $result);
        $this->assertEquals('admin', $result->first()->role);
    }

    /** @test */
    public function it_handles_empty_results_correctly()
    {
        $result = User::where('status', 'nonexistent')
                     ->get();

        $this->assertCount(0, $result);
        $this->assertTrue($result->isEmpty());
    }
}

2. デバッグツールの活用

// クエリログの取得
\DB::enableQueryLog();

$users = User::where('status', 'active')
             ->where('role', 'admin')
             ->get();

$queryLog = \DB::getQueryLog();
\Log::info('Executed queries:', $queryLog);

// クエリビルダのデバッグ
$query = User::where('status', 'active')
             ->where('role', 'admin');

dd($query->toSql(), $query->getBindings());

// パフォーマンスのプロファイリング
\DB::listen(function($query) {
    \Log::info(sprintf(
        'Query: %s; Bindings: %s; Time: %s ms',
        $query->sql,
        json_encode($query->bindings),
        $query->time
    ));
});

これらの注意点とトラブルシューティング手法を理解し、適切に実装することで、より安全で保守性の高いアプリケーションを開発することができます。次のセクションでは、これらの知識を活用した実践的な実装例について解説します。

実践的な実装例と応用テクニック

検索フォームの実装例とコード解説

1. 高度な検索フォームの実装

// app/Http/Requests/ProductSearchRequest.php
class ProductSearchRequest extends FormRequest
{
    public function rules()
    {
        return [
            'category_id' => 'nullable|exists:categories,id',
            'price_min' => 'nullable|numeric|min:0',
            'price_max' => 'nullable|numeric|gt:price_min',
            'status' => 'nullable|in:available,sold_out,discontinued',
            'tags' => 'nullable|array',
            'tags.*' => 'exists:tags,id',
            'sort_by' => 'nullable|in:price_asc,price_desc,newest,popular'
        ];
    }
}

// app/Http/Controllers/ProductController.php
class ProductController extends Controller
{
    public function search(ProductSearchRequest $request)
    {
        $query = Product::query();

        // カテゴリーによるフィルタリング
        $query->when($request->filled('category_id'), function($q) use ($request) {
            $q->where('category_id', $request->category_id);
        });

        // 価格範囲によるフィルタリング
        $query->when($request->filled('price_min'), function($q) use ($request) {
            $q->where('price', '>=', $request->price_min);
        })->when($request->filled('price_max'), function($q) use ($request) {
            $q->where('price', '<=', $request->price_max);
        });

        // ステータスによるフィルタリング
        $query->when($request->filled('status'), function($q) use ($request) {
            $q->where('status', $request->status);
        });

        // タグによるフィルタリング
        $query->when($request->filled('tags'), function($q) use ($request) {
            $q->whereHas('tags', function($q) use ($request) {
                $q->whereIn('tags.id', $request->tags);
            });
        });

        // ソート処理
        $query->when($request->filled('sort_by'), function($q) use ($request) {
            switch ($request->sort_by) {
                case 'price_asc':
                    $q->orderBy('price', 'asc');
                    break;
                case 'price_desc':
                    $q->orderBy('price', 'desc');
                    break;
                case 'newest':
                    $q->latest();
                    break;
                case 'popular':
                    $q->withCount('orders')
                      ->orderBy('orders_count', 'desc');
                    break;
            }
        });

        return $query->with(['category', 'tags'])
                    ->paginate(20);
    }
}

2. Blade テンプレートの実装

<!-- resources/views/products/search.blade.php -->
<form action="{{ route('products.search') }}" method="GET">
    <div class="search-filters">
        <div class="category-filter">
            <select name="category_id">
                <option value="">カテゴリー選択</option>
                @foreach($categories as $category)
                    <option value="{{ $category->id }}" 
                            {{ request('category_id') == $category->id ? 'selected' : '' }}>
                        {{ $category->name }}
                    </option>
                @endforeach
            </select>
        </div>

        <div class="price-filter">
            <input type="number" name="price_min" 
                   value="{{ request('price_min') }}" 
                   placeholder="最小価格">
            <input type="number" name="price_max" 
                   value="{{ request('price_max') }}" 
                   placeholder="最大価格">
        </div>

        <div class="status-filter">
            @foreach(['available', 'sold_out', 'discontinued'] as $status)
                <label>
                    <input type="radio" name="status" 
                           value="{{ $status }}"
                           {{ request('status') == $status ? 'checked' : '' }}>
                    {{ __("products.status.$status") }}
                </label>
            @endforeach
        </div>

        <div class="sort-filter">
            <select name="sort_by">
                <option value="">並び替え</option>
                <option value="price_asc" {{ request('sort_by') == 'price_asc' ? 'selected' : '' }}>
                    価格: 安い順
                </option>
                <option value="price_desc" {{ request('sort_by') == 'price_desc' ? 'selected' : '' }}>
                    価格: 高い順
                </option>
                <option value="newest" {{ request('sort_by') == 'newest' ? 'selected' : '' }}>
                    新着順
                </option>
                <option value="popular" {{ request('sort_by') == 'popular' ? 'selected' : '' }}>
                    人気順
                </option>
            </select>
        </div>
    </div>

    <button type="submit">検索</button>
</form>

動的な条件生成によるフィルタリング機能の実装

1. クエリビルダーの拡張

// app/QueryBuilders/ProductQueryBuilder.php
class ProductQueryBuilder extends Builder
{
    public function applyFilters(array $filters)
    {
        foreach ($filters as $field => $value) {
            if (method_exists($this, $method = 'filter' . studly_case($field))) {
                $this->$method($value);
            }
        }

        return $this;
    }

    protected function filterPrice($price)
    {
        if (isset($price['min'])) {
            $this->where('price', '>=', $price['min']);
        }

        if (isset($price['max'])) {
            $this->where('price', '<=', $price['max']);
        }

        return $this;
    }

    protected function filterCategories($categories)
    {
        return $this->whereIn('category_id', (array)$categories);
    }

    protected function filterSearch($keyword)
    {
        return $this->where(function($query) use ($keyword) {
            $query->where('name', 'LIKE', "%{$keyword}%")
                  ->orWhere('description', 'LIKE', "%{$keyword}%");
        });
    }
}

// app/Models/Product.php
class Product extends Model
{
    public function newEloquentBuilder($query)
    {
        return new ProductQueryBuilder($query);
    }
}

2. 高度なフィルタリングの実装

// app/Services/ProductFilterService.php
class ProductFilterService
{
    public function apply(Builder $query, array $filters)
    {
        // 基本的なフィルター
        $query->when(isset($filters['keyword']), function($q) use ($filters) {
            $q->filterSearch($filters['keyword']);
        });

        // 価格範囲フィルター
        $query->when(isset($filters['price']), function($q) use ($filters) {
            $q->filterPrice($filters['price']);
        });

        // カテゴリーフィルター
        $query->when(isset($filters['categories']), function($q) use ($filters) {
            $q->filterCategories($filters['categories']);
        });

        // 在庫状態フィルター
        $query->when(isset($filters['stock_status']), function($q) use ($filters) {
            if ($filters['stock_status'] === 'in_stock') {
                $q->where('stock', '>', 0);
            } elseif ($filters['stock_status'] === 'out_of_stock') {
                $q->where('stock', 0);
            }
        });

        // 公開状態フィルター
        $query->when(isset($filters['published']), function($q) use ($filters) {
            $q->where('is_published', $filters['published']);
        });

        return $query;
    }
}

複雑な検索条件の実装パターンと使い分け

1. 複合条件を使用した高度な検索

// app/Http/Controllers/OrderController.php
class OrderController extends Controller
{
    public function advancedSearch(Request $request)
    {
        $query = Order::query();

        // 期間による絞り込み
        $query->when($request->filled(['date_from', 'date_to']), function($q) use ($request) {
            $q->whereBetween('created_at', [
                Carbon::parse($request->date_from)->startOfDay(),
                Carbon::parse($request->date_to)->endOfDay()
            ]);
        });

        // 注文状態による絞り込み
        $query->when($request->filled('status'), function($q) use ($request) {
            $q->whereIn('status', (array)$request->status);
        });

        // 金額範囲による絞り込み
        $query->when($request->filled(['amount_min', 'amount_max']), function($q) use ($request) {
            $q->whereBetween('total_amount', [
                $request->amount_min,
                $request->amount_max
            ]);
        });

        // 顧客情報による検索
        $query->when($request->filled('customer_keyword'), function($q) use ($request) {
            $q->whereHas('customer', function($q) use ($request) {
                $q->where('name', 'LIKE', "%{$request->customer_keyword}%")
                  ->orWhere('email', 'LIKE', "%{$request->customer_keyword}%");
            });
        });

        // 商品による検索
        $query->when($request->filled('product_ids'), function($q) use ($request) {
            $q->whereHas('orderItems', function($q) use ($request) {
                $q->whereIn('product_id', $request->product_ids);
            });
        });

        // 支払い方法による絞り込み
        $query->when($request->filled('payment_method'), function($q) use ($request) {
            $q->where('payment_method', $request->payment_method);
        });

        return $query->with(['customer', 'orderItems.product'])
                    ->latest()
                    ->paginate(20);
    }
}

この実践的な実装例とテクニックを活用することで、より柔軟で保守性の高いアプリケーションを開発することができます。また、これらのパターンを基に、プロジェクトの要件に応じてカスタマイズを行うことで、効率的な開発が可能になります。