本文介绍如何用 laravel 的 `when()` 方法替代冗长的 if-elseif 链，动态构建数据库查询，使多条件搜索逻辑更简洁、可读性更强、易于维护。
在 Laravel 开发中，处理前端传来的多字段组合搜索（如关键词、日期范围、员工 ID 等）时，若采用传统 if/elseif 嵌套判断，不仅代码臃肿、易出错，还严重违背“开闭原则”——新增一个搜索字段就得修改主逻辑分支。幸运的是，Laravel 提供了强大的 条件式查询构造器 —— when() 方法，它能以声明式、链式的方式按需添加查询约束，彻底简化此类场景。
✅ 推荐写法：使用 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) {
// 注意：此处使用 where + orWhere 组合需包裹在闭包中避免逻辑歧义
$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();? 关键说明： $request->filled() 自动忽略空字符串、null、0（非 0.0 或 '0'）等“空值”，比手动判断 == '' 更健壮； 对于含 orWhere 的搜索字段（如 keyvalue），必须用 where(function () {}) 包裹，否则会破坏 SQL 的 AND 优先级，导致意外全表匹配； 所有 when() 调用均为惰性执行——仅当条件为真时才注入对应 where 子句，最终生成的 SQL 精准反映实际传参。
⚠️ 注意事项与最佳实践
- 避免 SQL 注入：示例中使用 "%{$value}%" 是安全的，因 Eloquent 会自动参数化绑定；切勿拼接原始 SQL 字符串（如 "%'{$value}%'）。
- 日期格式校验：生产环境建议在控制器中预验证 datefrom/dateto 是否为有效日期（可用 date_format:Y-m-d 规则）。
-
性能优化：对高频搜索字段（如 sr_name, tel_code）建立数据库复合索引，例如：
ALTER TABLE countries ADD INDEX idx_search (sr_status, created_at, sr_name, tel_code);
- 扩展性设计：未来新增搜索字段（如 region）只需追加一行 when($request->filled('region'), ...)，无需改动既有结构。
✅ 总结
用 when() 替代 if-elseif 不仅让代码行数减少 60%+，更将“业务意图”（当用户输入了 X，就按 X 搜索）直接映射为代码，大幅提升可维护性与协作效率。这是 Laravel “约定优于配置”哲学的典型体现——善用框架原生能力，而非重复造轮子。从今天起，告别嵌套地狱，拥抱清晰、函数式、可组合的查询构建方式。
