Laravel 9：可选路由参数结合Eloquent查询及图书筛选架构实现

1. Laravel 9中whereHas()与可选路由参数结合的实现方式 #

whereHas()用于关联模型的条件查询，和可选路由参数结合时，核心逻辑是仅当参数非空时才执行关联筛选。举个例子，假设Book模型关联Author模型，要根据可选的作者名称路由参数筛选图书：

public function getBooks($authorName = null)
{
    return Book::query()
        // 当$authorName不为空时，执行关联查询
        ->when($authorName, function ($query) use ($authorName) {
            $query->whereHas('author', function ($subQuery) use ($authorName) {
                $subQuery->where('name', $authorName);
            });
        })
        ->get();
}

关键注意点：

• 用use()将路由参数传入闭包
• when()方法的第一个参数是判断条件，非空则执行后续闭包逻辑

2. 图书馆筛选场景的路由与控制器优化方案 #

路由构建 #

合并为带可选参数的单路由是更简洁的方案，建议给参数添加约束（比如UUID的正则匹配），避免无效请求：

Route::get('/library/{type?}/{genre?}/{author?}/{bookTitle?}/{uuid?}', [BookController::class, 'filterBooks'])
    ->where('uuid', '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}');

说明：

• bookTitle属于SEO友好的冗余参数，实际查询无需依赖它，仅用于美化URL
• UUID的正则约束确保只有符合格式的参数才会进入控制器

控制器查询逻辑优化 #

原代码的问题是错误使用了$request->type（路由参数并非请求参数），正确的写法应该直接使用函数接收的路由参数，同时针对UUID单独处理（因为UUID是唯一标识，直接查询单本效率更高）：

public function filterBooks($type = null, $genre = null, $author = null, $bookTitle = null, $uuid = null)
{
    $query = Book::query();

    // 存在UUID时直接返回单本图书，无需走列表查询
    if ($uuid) {
        return $query->where('uuid', $uuid)->firstOrFail();
    }

    // 依次根据非空参数添加筛选条件
    $query->when($type, fn($q) => $q->where('type', $type))
          ->when($genre, fn($q) => $q->where('genre', $genre))
          ->when($author, fn($q) => $q->where('author', $author));

    return $query->get();
}

是否适合使用Spatie Laravel Query Builder？ #

非常适合，尤其是当未来可能扩展筛选、排序、分页等功能时。这个包能大幅减少重复代码，让查询逻辑更简洁。示例用法：

use Spatie\QueryBuilder\QueryBuilder;

public function filterBooks($type = null, $genre = null, $author = null, $bookTitle = null, $uuid = null)
{
    if ($uuid) {
        return Book::where('uuid', $uuid)->firstOrFail();
    }

    // 过滤掉空参数，生成筛选数组
    $validFilters = array_filter([
        'type' => $type,
        'genre' => $genre,
        'author' => $author,
    ]);

    return QueryBuilder::for(Book::class)
        ->allowedFilters(array_keys($validFilters))
        ->where($validFilters)
        ->get();
}

如果当前筛选需求固定且简单，自定义when()逻辑足够；但如果需要灵活的扩展能力，使用该包能节省大量开发时间，代码可读性也更强。

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