Laravel模型关联约束？关联约束怎样添加？-Laravel-PHP中文网

关联约束是在加载或查询模型时对关联模型添加条件限制，主要通过闭包实现。使用with()可在预加载时筛选关联数据，如只加载已发布的帖子；whereHas()则用于根据关联条件筛选主模型，如获取有已发布帖子的用户。两者区别在于：with()不影响主模型查询结果，仅过滤关联数据；whereHas()则过滤主模型本身。可结合使用以同时满足筛选与加载需求。还可通过闭包添加复杂条件，如多层where、orWhere、排序、withCount及嵌套关联筛选，实现精确数据获取，提升性能并避免N+1问题。

laravel模型关联约束？关联约束怎样添加？

Laravel模型关联约束，简单来说，就是我们在加载或查询一个模型时，对它所关联的其他模型施加额外的条件限制。这就像你在图书馆找书，不仅要找某个作者的书，还要这些书是近五年出版的，这就是一个约束。它的添加方式主要通过在查询构建器中利用闭包（closure）来定义，无论是预加载（eager loading）还是基于关联模型的筛选，都离不开这种机制。

解决方案

在Laravel中，为模型关联添加约束主要有几种方式，它们各自服务于不同的场景和需求。

最常见也最直接的，是在使用

with()

登录后复制

方法进行预加载时，通过传入一个闭包来定义对关联模型的额外筛选条件。比如，我们想获取所有用户，但只预加载他们中“已发布”的帖子：

User::with(['posts' => function ($query) {
    $query->where('status', 'published');
}])->get();

登录后复制

这里，

posts

登录后复制

关系只加载那些

status

登录后复制

字段为

published

登录后复制

的帖子。用户的其他帖子，即使存在，也不会被加载到

posts

登录后复制

集合中。

另一种情况是，我们不仅要筛选关联模型，还要根据关联模型是否存在或满足特定条件来筛选主模型。这时，

whereHas()

登录后复制

和

orWhereHas()

登录后复制

就派上用场了。假设我们只想获取那些至少有一篇“已发布”帖子的用户：

User::whereHas('posts', function ($query) {
    $query->where('status', 'published');
})->get();

登录后复制

这会返回所有拥有至少一篇

status

登录后复制

为

published

登录后复制

的帖子的用户。如果一个用户所有的帖子都不是

published

登录后复制

状态，那么这个用户就不会被返回。

还有一种稍微高级点的用法，你可以直接在模型关联方法中定义默认的约束。但这通常用于全局性的、始终适用的约束，例如一个

activePosts

登录后复制

方法：

// User.php
public function activePosts()
{
    return $this->hasMany(Post::class)->where('is_active', true);
}

// 使用时
$user->activePosts; // 默认只会加载活跃的帖子

登录后复制

这种方法的好处是，你在任何地方调用

activePosts

登录后复制

时，都不需要重复写

where('is_active', true)

登录后复制

这个条件了。

为什么我们需要关联约束？

在我看来，关联约束不仅仅是SQL语句里加个

WHERE

登录后复制

子句那么简单，它更是我们优化数据加载、提升应用性能和精细化业务逻辑的关键。

想象一下，你有一个博客系统，用户可以发布很多帖子。如果没有关联约束，当你尝试显示一个用户的所有帖子时，可能会加载出包括草稿、已删除等各种状态的帖子。这不仅会浪费内存，增加数据库查询的负担，还可能在前端展示时需要额外的逻辑去过滤，导致代码变得臃肿。

我记得有一次，我们做了一个功能，需要展示某个分类下的所有产品，但这些产品必须是“有库存”且“上架”的。如果直接加载所有产品，再在PHP层面过滤，遇到几万个产品时，那性能简直是灾难。这时候，通过关联约束，我们可以在数据库层面就完成这些筛选，比如：

Category::with(['products' => function ($query) {
    $query->where('stock', '>', 0)
          ->where('is_published', true);
}])->get();

登录后复制

这样，数据库只返回我们真正需要的数据，大大减少了数据传输量和处理时间。它避免了所谓的“N+1问题”在加载关联数据时的无谓消耗，也让我们的业务逻辑更清晰地体现在数据查询层。

with()

登录后复制

和

whereHas()

登录后复制

的区别与选择？

这确实是初学者，甚至是一些经验丰富的开发者，也常常会混淆的地方。理解它们的本质差异，对于写出高效的Laravel代码至关重要。

with()

登录后复制

约束，它的核心目的是预加载（eager load）关联数据，并且在加载这些关联数据时施加条件。这意味着，无论关联数据是否满足你的条件，主模型（比如

User

登录后复制

）都会被查询出来。约束只作用于关联模型的加载过程。

举个例子：

可图大模型

可图大模型（Kolors）是快手大模型团队自研打造的文生图AI大模型

查看详情

$users = User::with(['posts' => function ($query) {
    $query->where('status', 'published');
}])->get();

登录后复制

这段代码会返回所有的用户。对于每个用户，它会尝试加载其关联的帖子，但只会加载那些

status

登录后复制

为

published

登录后复制

的帖子。如果一个用户有10篇帖子，其中5篇是

published

登录后复制

，那么这个用户的

posts

登录后复制

集合里就只有这5篇帖子。如果一个用户没有任何

published

登录后复制

状态的帖子，那么他的

posts

登录后复制

集合就会是空的，但用户本身依然在结果集中。

whereHas()

登录后复制

约束，它的核心目的是筛选主模型，基于关联模型是否满足特定条件。它只关心是否存在符合条件的关联模型，而不负责加载这些关联模型。

再看一个例子：

$users = User::whereHas('posts', function ($query) {
    $query->where('status', 'published');
})->get();

登录后复制

这段代码会只返回那些至少拥有一篇

status

登录后复制

为
published
登录后复制
的帖子的用户。如果一个用户没有任何

published

登录后复制

状态的帖子，那么这个用户就不会出现在结果集中。重要的是，
whereHas()
登录后复制
默认不会预加载任何关联的帖子。如果你需要这些帖子，你需要额外再调用

with()

登录后复制

：

$users = User::whereHas('posts', function ($query) {
    $query->where('status', 'published');
})->with(['posts' => function ($query) { // 如果需要同时加载这些帖子
    $query->where('status', 'published');
}])->get();

登录后复制

选择策略：

如果你只需要根据关联数据来过滤主模型，并且不需要加载这些关联数据，那么用
```
whereHas()
```
登录后复制
。它的效率更高，因为它只进行存在性检查。
如果你既要根据关联数据来过滤主模型，又需要加载这些满足条件的关联数据，那么你需要结合使用
```
whereHas()
```
登录后复制
和
```
with()
```
登录后复制
，就像上面最后一个例子所示。
如果你不需要过滤主模型，只是想在预加载关联数据时对关联数据进行筛选，那么只用
```
with()
```
登录后复制
约束就足够了。

我个人的经验是，很多时候我们会先用

whereHas()

登录后复制

来缩小主模型的范围，然后再用

with()

登录后复制

来精细化加载所需的关联数据，这样能最大化地减少不必要的数据传输和处理。

如何在关联关系中添加更复杂的条件？

在实际开发中，简单的

WHERE

登录后复制

条件往往不够用。Laravel的关联约束闭包提供了完整的查询构建器功能，这意味着你可以施加任何复杂的SQL条件。

比如，我们不仅要筛选已发布的帖子，还要它们是最近一个月内发布的，并且按评论数倒序排列：

User::with(['posts' => function ($query) {
    $query->where('status', 'published')
          ->where('created_at', '>', now()->subMonth())
          ->withCount('comments') // 假设需要按评论数排序
          ->orderByDesc('comments_count');
}])->get();

登录后复制

这里，我们链式调用了多个

WHERE

登录后复制

条件，甚至使用了

withCount

登录后复制

来计算关联模型的数量，并基于此进行排序。

你也可以在约束中使用

orWhere

登录后复制

、

whereIn

登录后复制

、

whereBetween

登录后复制

等各种方法：

// 获取用户，并预加载他们的帖子，这些帖子要么是“发布”状态，要么是“草稿”状态且标题包含“Laravel”
User::with(['posts' => function ($query) {
    $query->where('status', 'published')
          ->orWhere(function ($q) {
              $q->where('status', 'draft')
                ->where('title', 'like', '%Laravel%');
          });
}])->get();

登录后复制

这个例子展示了如何使用嵌套的闭包来构建更复杂的

OR

登录后复制

条件组。这在处理多重逻辑判断时非常有用，能够确保SQL语句的逻辑正确性。

有时候，我们可能需要基于关联的关联来筛选。比如，我们想获取那些至少有一篇帖子，且这篇帖子至少有一个“点赞”的用户。这可以通过嵌套

whereHas

登录后复制

来实现：

User::whereHas('posts', function ($postQuery) {
    $postQuery->whereHas('likes'); // 筛选有“点赞”的帖子
})->get();

登录后复制

这里的

likes

登录后复制

是

Post

登录后复制

模型的一个关联关系。这种嵌套能力让我们可以从深层次的关联数据中提取信息，并以此来筛选顶级模型。

总而言之，关联约束的闭包参数就是Laravel的查询构建器实例，你可以像构建任何普通查询一样，在其中添加各种复杂的条件、排序、分组甚至联接操作。这为我们提供了极大的灵活性和强大的控制力，来精确地获取我们所需的数据。但也要注意，过度复杂的关联约束可能会导致SQL查询变得非常复杂，影响性能，所以在使用时也要权衡。

以上就是Laravel模型关联约束？关联约束怎样添加？的详细内容，更多请关注php中文网其它相关文章！