如何实现一个Laravel查询过滤器(laravel,编程语言)

在撰写本文时，我在 PHP 8.1 和 MySQL 8 上使用 Laravel 9。我相信技术栈不是一个大问题，这里我们主要关注构建一个查询过滤器系统。在本文中，我将演示为 users 表构建过滤器。

此外，我还使用 Laravel Telescope 轻松监控查询。

在学习使用 Laravel 的第一天，我经常直接在控制器上调用过滤器。简单，没有魔法，容易理解，但是这种方式有问题：

控制器中放置的大量逻辑导致控制器膨胀

不能重复使用

许多相同的工作重复

为了能够在过滤期间隐藏逻辑，让我们尝试使用 Laravel 的 Local Scope。将查询转换为 User 模型中的函数范围：

通过这种设置，我们将大部分数据库操作移到了模型类中，但是代码重复非常多。示例 2 的名称和电子邮件范围过滤器相同，性别生日和 is_active/is_admin 组相同。我们将对类似的查询功能进行分组。

至此，我们已经对大部分重复项进行了分组。但是，删除 if 语句或将这些过滤器扩展到另一个模型有点困难。我们正在寻找一种方法来彻底解决这个问题。

管道设计模式是一种设计模式，它提供了逐步构建和执行一系列操作的能力。 Laravel 有内置的 Pipeline 让我们可以很容易地在实际中应用这种设计模式，但由于某种原因，它没有在官方文档中列出。 Laravel 本身也将 Pipeline 应用于请求和响应之间的中间件。最基本的，要在 Laravel 中使用 Pipeline，我们可以这样使用

对于我们的问题，可以将初始查询 User:query() 传递给 pipeline，通过过滤器步骤，并返回应用过滤器的查询构建器。

现在我们需要构建管道过滤器：

通过将每个查询逻辑移动到一个单独的类，我们解锁了使用 OOP 的定制可能性，包括多态、继承、封装、抽象。比如你在 pipeline 的 handle 函数中看到，只有 if 语句中的逻辑不同，我会通过创建抽象类 BaseFilter 的方式将其分离抽象出来

现在我们的过滤器直观且高度可重用，易于实现甚至扩展，只需创建一个管道，扩展 BaseFilter 并声明函数 apply 即可应用到 Pipeline.中。

此时，我们将尝试在控制器上隐藏 Pipeline，通过在 Model 中创建一个调用 Pipeline 的作用域来使我们的代码更简洁。

用户现在可以从任何地方调用过滤器。但是其他模型也想实现过滤，我们将创建一个包含范围的 Trait，并在模型内部声明参与过滤过程的 Pipeline。