本文介绍如何利用 laravel 的 `when()` 条件查询方法，替代冗长的 if-elseif 链式判断，实现动态、可读性强且健壮的数据库搜索逻辑。
在 Laravel 开发中，处理前端传来的多字段组合搜索（如关键词、日期范围、员工 ID 等）时，若采用传统 if/elseif 嵌套方式构建查询，不仅代码臃肿、难以维护，还极易因逻辑分支遗漏导致 SQL 错误或数据漏查。Laravel 提供的 when() 方法正是为此类场景量身打造的优雅解决方案——它允许你按需添加查询子句，仅当指定条件为真时才执行对应闭包，从而让构建动态查询变得声明式、链式且高度可读。
以下是一个优化后的完整示例，适用于 Country 模型的复合搜索：
$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) {
$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();✅ 关键优化点说明：
HISUI 前端框架开发指南（IRIS版）
下载
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- filled() 替代 !== ''：自动过滤空字符串、null、[] 等“空值”，语义更准确；
- 用 where(...) 包裹 OR 条件：避免因 orWhere 优先级问题导致意外全表匹配（原代码中未加分组，存在严重 SQL 逻辑漏洞）；
- 链式调用 + 闭包注入：每个条件独立、无耦合，新增字段只需追加一个 when() 即可；
- 自动跳过未填写字段：无需手动判断所有组合，when() 内部已做短路处理。
⚠️ 注意事项：
- 若 keyvalue 搜索需跨多个字段且要求任一匹配即返回记录（即 OR 关系），必须用 where(function ($q) { ... }) 显式包裹，否则 orWhere 会与前面的 where 形成错误的混合逻辑；
- 建议对搜索字段添加数据库索引（如 sr_name, created_at, prep_emp），提升大数据量下的响应速度；
- 生产环境务必对用户输入进行校验（如日期格式验证），避免 SQL 异常或注入风险（本例中 LIKE 拼接虽非直接注入，但仍建议结合 Str::of()->escapeLike() 或参数化处理增强安全性）。
通过 when() 方法重构后，原本超过 50 行的嵌套判断被压缩为不到 20 行清晰链式代码，既提升了可维护性，也显著降低了逻辑出错概率——这是 Laravel “约定优于配置”理念在实际开发中的典型实践。
