在 Laravel 中动态构建与连接 whereHas 条件查询

碧海醫心

发布时间：2025-09-10 12:13:28

857人浏览过

来源于php中文网

原创

在 Laravel 中动态构建与连接 whereHas 条件查询

在 Laravel Eloquent 中，whereHas 方法是处理模型关联查询的强大工具，它允许我们根据关联模型的属性来筛选主模型。然而，在实际开发中，我们经常需要根据用户的输入或业务逻辑动态地添加或修改 whereHas 条件。本教程将深入探讨如何在不牺牲代码可读性和可维护性的前提下，实现 whereHas 条件的动态构建与连接。

理解 whereHas 的基本用法与挑战

首先回顾 wherehas 的基本用法：

use App\Models\Post;
use Illuminate\Database\Eloquent\Builder;

$posts = Post::whereHas('comments', function (Builder $query) {
    $query->where('content', 'like', 'code%');
})->get();

当需要添加更多条件时，一种常见的做法是将所有逻辑集中在一个闭包内：

use App\Models\Post;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\Request;

$request = new Request(['user_id' => 123]); // 模拟请求

$posts = Post::whereHas('comments', function (Builder $query) use ($request) {
    $query->where('content', 'like', 'code%');
    if ($request->has('user_id') && $request->user_id > 0) {
        $query->where('user_id', $request->user_id);
    }
})->get();

这种方式在条件较少时可行，但当条件复杂、来源多样或需要跨多个方法构建时，可能会导致闭包内部逻辑过于庞大，难以管理。用户提出的问题正是在寻求一种更灵活的方式，避免将所有条件紧密耦合。

策略一：链式调用 whereHas

Laravel 的查询构建器返回自身实例，这意味着我们可以链式调用多个 whereHas 方法。每个 whereHas 调用都会作为独立的条件添加到主查询中，它们之间默认是 AND 关系。

示例代码： 假设我们需要筛选包含特定内容评论的帖子，并且这些评论必须由特定用户发布。

use App\Models\Post;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\Request;

// 模拟请求
$request = new Request(['user_id' => 123]); // 假设用户ID为123

// 初始化查询构建器
$postsQuery = Post::query();

// 第一个 whereHas 条件：评论内容包含 'code%'
$postsQuery->whereHas('comments', function (Builder $query) {
    $query->where('content', 'like', 'code%');
});

// 第二个 whereHas 条件：如果请求中包含 user_id，则添加
// 注意：这里我们不是替换，而是继续在 $postsQuery 上添加条件
if ($request->has('user_id') && $request->user_id > 0) {
    $postsQuery->whereHas('comments', function (Builder $query) use ($request) {
        $query->where('user_id', $request->user_id);
    });
}

$posts = $postsQuery->get();

/*
   最终生成的SQL大致会是：
   SELECT * FROM posts
   WHERE EXISTS (SELECT * FROM comments WHERE posts.id = comments.post_id AND content LIKE 'code%')
     AND EXISTS (SELECT * FROM comments WHERE posts.id = comments.post_id AND user_id = 123)
*/

通过链式调用，每个 whereHas 条件都是独立的，但在逻辑上是相互关联的。这种方法清晰地分离了不同的筛选逻辑。

注意事项：

确保始终操作同一个查询构建器实例（例如，通过将结果赋值回 $postsQuery 变量），而不是每次都从 Post::whereHas(...) 开始，那样会覆盖之前的条件。
多个 whereHas 调用在主查询层面是 AND 关系。如果需要 OR 关系，可能需要使用 orWhereHas 或更复杂的嵌套条件。

策略二：利用 when() 方法实现条件式 whereHas

Laravel 的 when() 方法提供了一种优雅的方式来根据条件应用查询子句。它接受两个参数：一个布尔条件和一个闭包。如果条件为真，闭包将被执行并接收查询构建器实例。

Figma

Figma 是一款基于云端的 UI 设计工具，可以在线进行产品原型、设计、评审、交付等工作。

下载

示例代码： 我们使用 when() 方法重写上面的例子，使其更加简洁和易读。

use App\Models\Post;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Http\Request;

// 模拟请求
$request = new Request(['user_id' => 123]); // 假设用户ID为123

$posts = Post::whereHas('comments', function (Builder $query) {
    $query->where('content', 'like', 'code%');
})->when($request->has('user_id') && $request->user_id > 0, function (Builder $query) use ($request) {
    // 如果条件为真，则在此处添加另一个 whereHas
    $query->whereHas('comments', function (Builder $innerQuery) use ($request) {
         $innerQuery->where('user_id', $request->user_id);
    });
})->get();

/*
   同样，最终生成的SQL会包含两个 EXISTS 子句，通过 AND 连接。
   SELECT * FROM posts
   WHERE EXISTS (SELECT * FROM comments WHERE posts.id = comments.post_id AND content LIKE 'code%')
     AND EXISTS (SELECT * FROM comments WHERE posts.id = comments.post_id AND user_id = 123)
*/

在这个例子中：