如何优化基于请求的多条件Eloquent查询管理机制？

问题背景 #

当请求参数越来越多的时候，用Eloquent的when方法堆砌查询条件会让代码变得臃肿不堪，比如这段示例代码：

if($request->has("parent")) {
    Specialization::where('id', $request->id)
        ->when($request->parent_id, function($query) use ($request){
            return $query->where('parent_id', $request->parent_id);
        });
}

有没有更清爽的方式来管理这些查询逻辑？比如拆分到独立类或者助手函数里？

方案1：用查询作用域（Query Scopes）把逻辑绑到模型上 #

这是最贴合Eloquent设计的方式，直接在Specialization模型里定义局部作用域，把每个筛选条件的逻辑封装起来：

// app/Models/Specialization.php
class Specialization extends Model
{
    // 按ID筛选的作用域
    public function scopeFilterById($query, $id)
    {
        return $query->when($id, fn($q) => $q->where('id', $id));
    }

    // 按父ID筛选的作用域
    public function scopeFilterByParentId($query, $parentId)
    {
        return $query->when($parentId, fn($q) => $q->where('parent_id', $parentId));
    }
}

调用的时候就非常简洁，可读性拉满：

if($request->has("parent")) {
    $specializations = Specialization::filterById($request->id)
        ->filterByParentId($request->parent_id)
        ->get();
}

后续加新参数，只需要在模型里加新的作用域就行，维护起来很方便。

方案2：封装独立的查询类（适合复杂场景） #

如果查询逻辑特别复杂，或者不想把太多逻辑塞到模型里，可以单独写一个查询类，把所有筛选逻辑集中管理：

// app/Queries/SpecializationQuery.php
namespace App\Queries;

use App\Models\Specialization;

class SpecializationQuery
{
    protected $query;

    public function __construct()
    {
        $this->query = Specialization::query();
    }

    public function whereId($id): self
    {
        if ($id) {
            $this->query->where('id', $id);
        }
        return $this;
    }

    public function whereParentId($parentId): self
    {
        if ($parentId) {
            $this->query->where('parent_id', $parentId);
        }
        return $this;
    }

    public function get()
    {
        return $this->query->get();
    }
}

控制器里调用的时候，链式调用非常清爽：

if($request->has("parent")) {
    $specializations = (new SpecializationQuery())
        ->whereId($request->id)
        ->whereParentId($request->parent_id)
        ->get();
}

这种方式完全把查询逻辑和控制器解耦，适合大型项目里的复杂查询场景。

方案3：助手函数（简单场景快速复用） #

如果是几个地方都要用到的简单筛选逻辑，可以封装成全局助手函数：

// app/helpers.php
function applySpecializationFilters($query, $request)
{
    return $query->when($request->id, fn($q) => $q->where('id', $request->id))
                 ->when($request->parent_id, fn($q) => $q->where('parent_id', $request->parent_id));
}

记得在composer.json里注册助手函数，然后执行composer dump-autoload。调用的时候：

if($request->has("parent")) {
    $specializations = applySpecializationFilters(Specialization::query(), $request)->get();
}

不过助手函数要注意别滥用，不然全局函数太多会导致维护混乱，只适合简单、复用率高的场景。

内容的提问来源于stack exchange，提问作者Faruh