Laravel 提供五种条件查询构造方法:一、when 动态添加条件;二、where 数组批量筛选;三、whereRaw 编写原生 SQL;四、when 与 unless 组合分支逻辑;五、本地作用域封装复用条件。

如果您在使用 Laravel 的 Eloquent ORM 或 Query Builder 进行数据库操作时,需要根据动态条件构建 SQL 查询,则需借助其灵活的条件查询构造器机制。以下是实现条件查询构造器的多种方法:
一、使用 when 方法动态添加查询条件
when 方法允许您仅在给定条件为 true 时才执行闭包中的查询链式调用,避免手动拼接 if-else 判断,使代码更简洁可读。
1、定义基础查询实例,例如 User::query()。
2、调用 when($condition, function ($query) { ... }),其中 $condition 为布尔表达式或变量。
3、在闭包中调用 where()、orderBy() 等方法添加条件。
4、最终调用 get() 或 first() 执行查询。
二、使用 where 条件数组批量应用筛选
当多个字段需同时按值精确匹配时,可直接传入关联数组给 where(),Laravel 自动将其转换为 AND 连接的等值条件。
1、准备一个键值对数组,如 ['status' => 'active', 'deleted_at' => null]。
2、将该数组作为第二个参数传入 where('users', $conditions)。
3、确保数组中键名为数据库字段名,值为期望匹配的值。
4、执行 get() 获取结果集。
三、使用 whereRaw 手动编写原生条件表达式
当需要使用数据库特有函数(如 MySQL 的 DATE()、LIKE 模糊匹配带通配符)、或复杂逻辑运算(如 IS NULL、BETWEEN)时,whereRaw() 提供了直接嵌入 SQL 片段的能力。
1、调用 whereRaw('created_at >= ?', [$date]),使用问号占位符防止 SQL 注入。
2、若需绑定多个参数,传入数组形式的第二个参数,如 ['2023-01-01', '2023-12-31']。
3、可在同一查询中多次调用 whereRaw() 与其他 where 方法混合使用。
4、注意确保 SQL 片段语法与所用数据库引擎兼容。
四、使用 when 和 unless 组合处理双向条件分支
unless 是 when 的逻辑反向方法,当条件为 false 时才执行闭包;两者配合可用于实现“满足 A 则查 X,否则查 Y”的分支逻辑。
1、初始化查询对象,如 Post::query()。
2、先调用 when($isPublished, function ($q) { return $q->where('published', true); })。
3、再调用 unless($isPublished, function ($q) { return $q->where('draft', true); })。
4、最后统一调用 paginate(15) 返回分页结果。
五、使用作用域(Local Scopes)封装复用条件逻辑
将常用条件组合抽象为模型上的本地作用域方法,可在任意查询中通过链式调用复用,提升可维护性与一致性。
1、在 Eloquent 模型类中定义以 scope 开头的公共方法,如 scopeActive($query)。
2、方法内部对传入的 $query 调用 where('status', 'active') 并返回 $query。
3、在控制器或服务中使用 User::active()->get() 触发该作用域。
4、支持接收参数的作用域命名为 scopeOfType($query, $type),调用时为 ->ofType('admin')。


















