Laravel Eloquent：使用 whereHas 高效过滤关联模型数据

本文深入探讨了在 Laravel Eloquent 中，如何正确地基于关联模型（如用户与中奖票据）过滤父级模型（如用户）。通过对比 `with()` 和 `whereHas()` 的不同作用，教程详细阐述了 `whereHas()` 在过滤父模型时的关键作用，并提供了结合 `with()` 进行高效数据加载与过滤的最佳实践，帮助开发者避免常见陷阱。

在 Laravel 应用开发中，我们经常需要根据关联模型的条件来筛选主模型数据。例如，在一个抽奖系统中，我们可能需要列出所有拥有中奖票据的用户。直观上，开发者可能会尝试使用 with() 方法来加载关联数据并添加过滤条件，但这种做法往往无法达到预期效果，即过滤父级模型。

理解 with() 与 whereHas() 的核心区别

with() 方法在 Eloquent 中主要用于“预加载”（Eager Loading）关联模型。它的作用是在查询主模型时，同时加载指定的关联模型数据，以减少 N+1 查询问题。然而，with() 内部的闭包条件仅作用于预加载的关联模型集合，并不会对主模型的查询结果进行过滤。这意味着，即使关联模型不满足条件，父级模型依然会被返回，只是其关联数据可能为空或仅包含满足条件的部分。

为了解决根据关联模型条件过滤父级模型的问题，Eloquent 提供了 whereHas() 方法。whereHas() 方法通过在底层生成 SQL WHERE EXISTS 子句，来确保只有那些至少存在一个满足指定条件的关联模型的父级模型才会被返回。

使用 whereHas() 过滤父级模型

假设我们有 User、Ticket 和 Prize 三个模型，一个用户可以拥有多张票据，一张票据关联一个用户，一个奖品会有一个中奖票据。我们的目标是找出所有拥有中奖票据的用户。

首先，我们需要获取所有中奖票据的 ID：

// 获取所有已选出中奖者的奖品的中奖票据ID
$winningTickets = Prize::WinnerSelected()->pluck('ticket_winner_id');

这里我们直接在 Builder 实例上调用 pluck()，而非先 get() 再 pluck()，这是一种更简洁高效的做法。

云雀语言模型

云雀是一款由字节跳动研发的语言模型，通过便捷的自然语言交互，能够高效的完成互动对话

54

查看详情

接下来，使用 whereHas() 来过滤 User 模型：

use App\Models\User;
use App\Models\Prize;

// 获取所有中奖票据的ID
$winningTickets = Prize::WinnerSelected()->pluck('ticket_winner_id');

// 使用 whereHas 过滤用户，只返回拥有中奖票据的用户
$users = User::whereHas('tickets', function($query) use ($winningTickets) {
    $query->whereIn('id', $winningTickets);
})->get();

// $users 集合现在只包含那些至少拥有一张ID在中奖票据列表中的用户

在这个例子中，whereHas('tickets', ...) 会确保只有与至少一张 id 存在于 $winningTickets 数组中的 Ticket 关联的 User 记录才会被返回。

结合 with() 和 whereHas() 实现过滤与预加载

在某些场景下，我们不仅需要过滤父级模型，还需要同时预加载满足过滤条件的关联模型数据。例如，我们希望获取所有拥有中奖票据的用户，并且每个用户只加载其对应的中奖票据。

这时，我们需要同时使用 with() 和 whereHas()。为了避免重复编写相同的过滤逻辑，我们可以将过滤闭包定义为一个可重用的变量：

use App\Models\User;
use App\Models\Prize;

// 获取所有中奖票据的ID
$winningTickets = Prize::WinnerSelected()->pluck('ticket_winner_id');

// 定义可重用的过滤闭包
$filterClause = function ($query) use ($winningTickets) {
    return $query->whereIn('id', $winningTickets);
};

// 结合 with 和 whereHas
$users = User::with(['tickets' => $filterClause]) // 预加载符合条件的票据
             ->whereHas('tickets', $filterClause) // 过滤用户，只返回拥有符合条件票据的用户
             ->get();

/*
$users 集合现在：
1. 只包含拥有至少一张中奖票据的用户（通过 whereHas 过滤）。
2. 每个用户实例的 'tickets' 关联集合中只包含其对应的中奖票据（通过 with 预加载）。
*/

通过这种方式，我们既实现了对父级模型的精确过滤，又优化了数据加载，避免了 N+1 问题，并且每个用户实例只加载了其相关的中奖票据，而非所有票据。

总结

在 Laravel Eloquent 中，理解 with() 和 whereHas() 的不同作用至关重要。with() 用于预加载关联数据，但不会过滤父级模型；而 whereHas() 则用于根据关联模型的条件来过滤父级模型。当需要同时实现过滤和预加载时，应结合使用这两个方法，并通过定义可重用闭包来提高代码的可读性和维护性。正确运用这些方法，能够帮助开发者构建出更高效、更健壮的数据库查询逻辑。

以上就是Laravel Eloquent：使用 whereHas 高效过滤关联模型数据的详细内容，更多请关注php中文网其它相关文章！