🎤 Laravel 条件查询的艺术：查询构造器的扩展方法与动态构建机制
大家好！欢迎来到今天的 Laravel 技术讲座 🎉。今天我们要聊的是一个非常有趣的话题——如何用 Laravel 的查询构造器（Query Builder）优雅地实现条件查询，以及如何通过扩展方法和动态构建机制让我们的代码更灵活、更强大。
如果你是一个喜欢折腾代码的开发者，那么这篇文章绝对会让你眼前一亮 😎。让我们开始吧！
🌟 查询构造器基础回顾
在 Laravel 中，Query Builder 是我们用来与数据库交互的强大工具。它允许我们以链式调用的方式构建 SQL 查询语句，而不需要直接写复杂的原始 SQL。
举个简单的例子：
$users = DB::table('users')
->where('age', '>', 18)
->orderBy('name', 'asc')
->get();这段代码的作用是查询所有年龄大于 18 岁的用户，并按照名字升序排列。是不是很简单？👏
但是，当我们需要根据不同的条件动态生成查询时，事情就变得复杂起来了。比如，如果用户可以选择是否按年龄过滤，或者选择是否按名字排序，该怎么办呢？
🛠 动态构建查询逻辑
动态构建查询的核心思想是：只在需要的时候添加条件。Laravel 提供了 when() 方法来帮助我们实现这一点。
when() 方法简介
when() 方法允许我们在满足某个条件时才执行特定的查询操作。它的语法如下：
DB::table('users')
->when($condition, function ($query) {
// 如果 $condition 为真，则执行这里的逻辑
})
->get();实战演练：动态过滤用户
假设我们有一个表单，用户可以选择以下条件来查询用户：
- 按年龄过滤（可选）
- 按性别过滤（可选）
- 按名字排序（可选）
我们可以这样写代码：
$query = DB::table('users');
if ($request->has('age')) {
$query->where('age', '>', $request->input('age'));
}
if ($request->has('gender')) {
$query->where('gender', $request->input('gender'));
}
if ($request->has('sort_by_name')) {
$query->orderBy('name', 'asc');
}
$users = $query->get();虽然这段代码可以工作，但随着条件的增加，代码会变得越来越冗长。这时，when() 就派上用场了：
$users = DB::table('users')
->when($request->has('age'), function ($query) use ($request) {
$query->where('age', '>', $request->input('age'));
})
->when($request->has('gender'), function ($query) use ($request) {
$query->where('gender', $request->input('gender'));
})
->when($request->has('sort_by_name'), function ($query) {
$query->orderBy('name', 'asc');
})
->get();怎么样？是不是简洁多了？😄
🔧 扩展方法策略
有时候，我们需要频繁地使用某些复杂的查询逻辑。与其每次都重复编写这些逻辑，不如将它们封装成扩展方法。
创建自定义查询方法
Laravel 允许我们通过 macro 方法扩展查询构造器的功能。下面是一个示例：
use IlluminateDatabaseQueryBuilder;
Builder::macro('filterByAgeAndGender', function ($age = null, $gender = null) {
if ($age) {
$this->where('age', '>', $age);
}
if ($gender) {
$this->where('gender', $gender);
}
return $this;
});然后，我们可以在查询中直接使用这个方法：
$users = DB::table('users')
->filterByAgeAndGender($request->input('age'), $request->input('gender'))
->get();这种方式不仅让代码更加清晰，还提高了复用性。👍
📊 表格对比：传统方式 vs. 动态构建 vs. 扩展方法
| 特性 | 传统方式 | 动态构建 | 扩展方法 |
|---|---|---|---|
| 可读性 | 较低 | 较高 | 非常高 |
| 复用性 | 无 | 有限 | 高 |
| 维护成本 | 高 | 中 | 低 |
| 适合场景 | 简单查询 | 条件较多的查询 | 频繁使用的复杂查询 |
🚀 结合 Eloquent 使用
除了查询构造器，Laravel 的 Eloquent ORM 也支持类似的动态构建和扩展方法。例如，我们可以通过 scope 方法创建查询范围：
class User extends Model
{
public function scopeFilterByAge($query, $age)
{
return $query->where('age', '>', $age);
}
}然后在查询中使用：
$users = User::filterByAge($request->input('age'))->get();Eloquent 的 scope 方法本质上是查询构造器的封装，因此我们可以轻松地将之前学到的知识应用到这里。
📚 国外技术文档引用
- Query Builder Documentation: The Query Builder provides a convenient, fluent interface to creating and running database queries. It can be used to perform most database operations in Laravel and works on all supported database systems.
- Macros in Query Builder: Macros allow you to extend the query builder with your own custom methods. This is useful for adding reusable functionality without having to write repetitive code.
🎉 总结
今天我们学习了如何在 Laravel 中优雅地实现条件查询。通过 when() 方法，我们可以动态构建查询逻辑；通过扩展方法或 Eloquent 的 scope，我们可以封装复杂的查询逻辑，提高代码的可读性和复用性。
希望这篇文章能让你对 Laravel 的查询构造器有更深的理解！如果你还有任何问题，欢迎留言交流 😊。
下次见啦！👋
