本文详解如何在 laravel 中基于用户提交的表单数据（如搜索字段）动态向查询中追加 where 条件，避免拼接原始 sql 字符串，确保代码安全、可读且符合 eloquent/query builder 最佳实践。
本文详解如何在 laravel 中基于用户提交的表单数据（如搜索字段）动态向查询中追加 where 条件，避免拼接原始 sql 字符串，确保代码安全、可读且符合 eloquent/query builder 最佳实践。
在 Laravel 开发中，常需根据前端表单提交的可选参数（例如地址字段 add1、add3 是否非空）动态筛选数据。与原生 PHP 中拼接 $sql 字符串不同，Laravel 的 Query Builder 支持链式调用与条件构建，既防止 SQL 注入，又提升可维护性。
以下是一个完整、健壮的实现方案：
✅ 正确做法：使用 when() 方法（推荐）
when() 是 Laravel 提供的语义化条件构造方法——仅当给定条件为真时，才执行闭包内的查询修饰逻辑，代码清晰且不易出错：
use Illuminate\Support\Facades\DB;
$BaseUsers = DB::table('users')
->join('user_infos', 'user_infos.user_id', '=', 'users.id')
->where('users.ustatus', '=', 1) // 原始固定条件
->select('users.*', 'user_infos.add1', 'user_infos.add3')
// 动态添加条件：仅当请求中存在且非空时生效
->when($request->filled('add_1'), function ($query) {
return $query->where('user_infos.add1', '!=', '');
})
->when($request->filled('add_3'), function ($query) {
return $query->where('user_infos.add3', '!=', '');
})
// 可继续扩展其他字段，如 age、status 等
->when($request->filled('age'), function ($query) use ($request) {
return $query->where('users.age', '>=', (int)$request->age);
})
->paginate(3);
? filled() 方法同时检查参数是否存在且不为空字符串/null/[]，比 has() 更适合表单校验场景（has() 仅判断键是否存在）。
⚠️ 注意事项与最佳实践
- 不要手动拼接 SQL：如 $sql .= " AND add1 ''" 易引发 SQL 注入、语法错误及难以调试；
- 避免重复调用 DB::table()：应在初始查询实例上链式追加条件，而非多次重建查询；
- 注意表别名与字段前缀：user_infos.add1 必须明确指定表名（或别名），避免歧义；
- 类型安全：对数字类参数（如年龄）显式转换 (int) 或使用 filter_var($v, FILTER_VALIDATE_INT)；
- 空值处理统一：若业务允许 NULL 地址，应改用 ->whereNotNull('user_infos.add1') 或 ->where('user_infos.add1', 'IS NOT', null)（需数据库支持）；
- 性能提示：高频动态查询建议为常用筛选字段添加数据库索引（如 user_infos.add1, users.ustatus）。
? 替代写法：传统 if + 查询实例（兼容旧版本）
若项目未升级至 Laravel 5.3+，或偏好显式控制流，也可采用如下方式：
$query = DB::table('users')
->join('user_infos', 'user_infos.user_id', '=', 'users.id')
->where('users.ustatus', 1)
->select('users.*', 'user_infos.add1', 'user_infos.add3');
if ($request->filled('add_1')) {
$query->where('user_infos.add1', '!=', '');
}
if ($request->filled('add_3')) {
$query->where('user_infos.add3', '!=', '');
}
$BaseUsers = $query->paginate(3);
该写法逻辑直白，但代码略冗长；而 when() 在可读性与扩展性上更胜一筹。
✅ 总结
Laravel 的 Query Builder 天然支持动态条件构建。优先使用 when() / unless() / filled() 等辅助方法，替代原始字符串拼接，不仅能写出更安全、更易测试的代码，也使后续维护（如新增筛选项、调整逻辑）变得轻而易举。始终牢记：查询逻辑属于业务层，而非字符串操作层。
