Laravel Eloquent 关联查询：实现每个父模型限制关联子模型数量

在 Laravel Eloquent 中，直接在 `hasMany` 关联的预加载查询中使用 `limit()` 方法，并不能实现为每个父模型限制关联子模型数量。默认行为是限制所有父模型关联子模型的总数。本文将详细介绍如何利用 `staudenmeir/eloquent-eager-limit` 扩展包，优雅地解决这一常见需求，实现对每个父模型关联子模型进行精确的数量限制。

理解 Laravel Eloquent 预加载的限制行为

当我们在 Laravel Eloquent 中使用 with() 方法进行预加载（Eager Loading），并尝试在关联查询的回调函数中应用 limit() 时，一个常见的误解是认为这将限制每个父模型所关联的子模型数量。例如，对于一个 Wedding 模型和其关联的多个 WeddingImage 模型，如果尝试如下操作：

$data = Wedding::with(['weddingimage' => function($q) {
    $q->where('is_cover', 0)
      ->limit(2); // 预期：每个 Wedding 获得最多 2 张图片
}])->get();

实际上，Laravel 的默认行为是限制 所有 Wedding 模型关联的 WeddingImage 记录的 总数。这意味着，如果数据库中有多个 Wedding 实例，并且它们总共关联了超过两张图片，这个 limit(2) 只会从所有符合条件的图片中选择前两张，并将它们分配给相应的 Wedding 模型。结果可能是一个 Wedding 模型获得了两张图片，而其他 Wedding 模型则没有任何图片，这与我们期望的“每个父模型限制”的目标不符。

解决方案：使用 staudenmeir/eloquent-eager-limit 扩展包

为了解决 Laravel Eloquent 默认行为的这一限制，我们可以借助由 Jonas Staudenmeir 开发的 staudenmeir/eloquent-eager-limit 扩展包。该扩展包专门为 Eloquent 提供了“每个父模型限制”的预加载功能。

1. 安装扩展包

首先，通过 Composer 将扩展包安装到您的 Laravel 项目中：

composer require staudenmeir/eloquent-eager-limit

2. 应用 Trait 到模型

安装完成后，您需要将 \Staudenmeir\EloquentEagerLimit\HasEagerLimit Trait 应用到所有需要进行“每个父模型限制”预加载的父模型和子模型上。

假设您的模型结构如下：

可图大模型

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

32

查看详情

• Wedding 模型（父模型）
• WeddingImage 模型（子模型）

则需要修改这两个模型文件：

app/Models/WeddingImage.php (子模型)

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Staudenmeir\EloquentEagerLimit\HasEagerLimit; // 导入 Trait

class WeddingImage extends Model
{
    use HasEagerLimit; // 使用 Trait

    // 其他模型定义...
}

app/Models/Wedding.php (父模型)

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Staudenmeir\EloquentEagerLimit\HasEagerLimit; // 导入 Trait
use App\Models\WeddingImage; // 导入关联模型

class Wedding extends Model
{
    use HasEagerLimit; // 使用 Trait

    // 其他模型定义...

    /**
     * 定义与 WeddingImage 的一对多关系
     */
    public function weddingimage()
    {
        return $this->hasMany(WeddingImage::class);
    }
}

3. 执行带有每个父模型限制的预加载查询

完成 Trait 的应用后，您现在可以在预加载查询中像预期那样使用 limit() 方法了。该扩展包会确保 limit() 行为应用于每个单独的父模型。

<?php

namespace App\Http\Controllers;

use App\Models\Wedding;
use Illuminate\Http\Request;

class WeddingController extends Controller
{
    public function index(Request $request)
    {
        // 示例：获取所有 Wedding，每个 Wedding 最多关联两张非封面图片
        $weddings = Wedding::with(['weddingimage' => function($q) {
            $q->where('is_cover', 0)
              ->limit(2); // 现在，这会为每个 Wedding 限制最多 2 张图片
        }])->get();

        // 遍历结果以验证
        foreach ($weddings as $wedding) {
            echo "Wedding ID: " . $wedding->id . "\n";
            echo "Total Images for this Wedding: " . $wedding->weddingimage->count() . "\n";
            foreach ($wedding->weddingimage as $image) {
                echo "  - Image ID: " . $image->id . "\n";
            }
            echo "--------------------\n";
        }

        return view('weddings.index', compact('weddings'));
    }
}

在上述代码中，->limit(2) 现在将正确地作用于每个 Wedding 模型，确保每个 Wedding 实例最多只加载两张符合 is_cover = 0 条件的 WeddingImage。

注意事项与总结

• 性能考量： staudenmeir/eloquent-eager-limit 扩展包通过巧妙的 SQL 查询（通常是利用子查询或 UNION 操作）来实现每个父模型的限制，这通常比手动循环每个父模型再加载关联数据要高效得多。
• 适用性： 此方法不仅适用于 hasMany 关系，也适用于 hasManyThrough 和 morphMany 等其他一对多类型的关系。
• 兼容性： 确保您使用的 Laravel 版本与扩展包要求的最低版本兼容。通常，该扩展包会积极维护以支持最新的 Laravel 版本。
• 替代方案（不推荐）： 在没有此扩展包的情况下，实现此功能通常需要手动循环父模型，然后对每个父模型单独加载关联数据，或者编写复杂的原生 SQL 查询，这些方法都远不如使用 staudenmeir/eloquent-eager-limit 优雅和高效。

通过集成 staudenmeir/eloquent-eager-limit 扩展包，您可以轻松克服 Laravel Eloquent 在处理“每个父模型限制关联子模型数量”时的默认行为限制，从而编写出更简洁、高效且符合预期的 Eloquent 查询。

以上就是Laravel Eloquent 关联查询：实现每个父模型限制关联子模型数量的详细内容，更多请关注php中文网其它相关文章！