Laravel条件查询构造器使用方法

Laravel 的条件查询构造器为开发者提供了灵活、安全且可维护的动态数据库查询能力，涵盖 when/ unless 动态分支控制、where 数组批量筛选、whereRaw 原生 SQL 精确介入、以及本地作用域封装复用等五大核心技巧——无论你是应对复杂搜索过滤、多场景权限判断，还是追求代码简洁性与SQL安全性，这套机制都能帮你告别冗长 if-else 拼接和硬编码 SQL，写出更优雅、健壮且易于扩展的查询逻辑。

如果您在使用 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')。

以上就是《Laravel条件查询构造器使用方法》的详细内容，更多关于的资料请关注golang学习网公众号！