如何使用 Laravel 的 when() 方法简化复杂的条件查询逻辑

本文介绍如何利用 laravel 查询构造器的 `when()` 方法，优雅地替代冗长的 if-elseif 条件链，实现动态、可读性强且易于维护的多条件数据库搜索。

在 Laravel 开发中，处理前端传入的多个可选搜索参数（如关键词、日期范围、员工 ID 等）时，若采用传统 if/elseif 嵌套判断，不仅代码臃肿、易出错，还极难扩展与测试。幸运的是，Laravel 提供了强大的 条件式查询构造器方法 when()，它允许你仅在条件为真时才向查询中添加对应子句，从而将原本分散、重复的逻辑收敛为一条链式、声明式的查询语句。

以下是优化后的完整实现：

$countries = Country::when($request->filled('status'), function ($query) use ($request) {
    $query->where('sr_status', 'LIKE', "%{$request->input('status')}%");
})
->when($request->filled('datefrom'), function ($query) use ($request) {
    $query->whereDate('created_at', '>=', $request->input('datefrom'));
})
->when($request->filled('dateto'), function ($query) use ($request) {
    $query->whereDate('created_at', '<=', $request->input('dateto'));
})
->when($request->filled('keyvalue'), function ($query) use ($request) {
    // 注意：此处需用 whereNested 避免 OR 优先级问题（关键！）
    $query->where(function ($q) use ($request) {
        $q->where('sr_name', 'LIKE', "%{$request->input('keyvalue')}%")
          ->orWhere('tel_code', 'LIKE', "%{$request->input('keyvalue')}%")
          ->orWhere('country_code', 'LIKE', "%{$request->input('keyvalue')}%")
          ->orWhere('currency_name', 'LIKE', "%{$request->input('keyvalue')}%");
    });
})
->when($request->filled('prepid'), function ($query) use ($request) {
    $query->where('prep_emp', 'LIKE', "%{$request->input('prepid')}%");
})
->orderBy('sr_id')
->get();

✅ 关键优化点说明：

• when($condition, Closure)：仅当 $condition 为 true（如字段非空、非 null、非空白字符串）时执行闭包内的查询追加；
• filled() 比 != '' 更健壮：自动过滤 null、[]、'' 等“空值”，避免因空格或意外输入导致逻辑错误；
• 重要修复：原答案中 orWhere 直接链式调用会导致 SQL 逻辑错误（OR 会脱离 AND 上下文）。我们通过 where(function ($q) { ... }) 将多字段 OR 包裹为一个原子条件组，确保其与 status、datefrom 等其他条件保持正确的 AND 关系；
• 所有条件均支持独立启用/禁用，无需手动组合 2⁴=16 种分支，彻底消除 if-elseif 维护噩梦；
• 代码线性、高内聚、低耦合，新增搜索字段只需追加一个 when() 调用即可。

? 额外建议：

• 对高频搜索字段（如 sr_name, tel_code）建立复合索引或全文索引以提升性能；
• 如需支持模糊匹配以外的精确筛选（如状态枚举），可结合 whereIn() 或 where() 增强健壮性；
• 生产环境务必对用户输入进行校验（如 datefrom/dateto 格式验证），防止 SQL 注入或异常报错（Laravel 的 whereDate 已做基础防护，但仍建议前置校验）。

通过 when()，你不再需要写“条件排列组合”，而是专注表达“当某条件存在时，就加上这个约束”——这才是现代 Laravel 查询应有的简洁与力量。