Laravel 中如何通过多列关联实现一对多嵌套关系并合并为单一集合-php教程-PHP中文网

Laravel 中如何通过多列关联实现一对多嵌套关系并合并为单一集合

本文介绍在 Laravel 中处理“一个产品关联基础单位，而该基础单位又拥有多个子单位”的场景，通过分层 Eloquent 关系（belongsTo + hasMany）结合模型辅助方法，将基础单位与子单位统一聚合为扁平化 units 集合，满足前端一体化渲染需求。

本文介绍在 laravel 中处理“一个产品关联基础单位，而该基础单位又拥有多个子单位”的场景，通过分层 eloquent 关系（belongsto + hasmany）结合模型辅助方法，将基础单位与子单位统一聚合为扁平化 `units` 集合，满足前端一体化渲染需求。

在实际业务中，常遇到单位体系的层级结构：例如「Piece（件）」是基础单位，「Dozen（一打 = 12 件）」是其子单位，二者通过 base_unit_id 关联。当一个 Product 关联到基础单位（如 unit_id = 1），我们期望一次性加载该基础单位及其所有子单位，并以扁平数组形式返回（而非嵌套结构），便于前端统一处理。

Laravel 原生的 belongsTo 不支持基于「两个条件」（如 unit_id = ? OR base_unit_id = ?）动态匹配多条记录，因此不能直接用单个关系实现“获取所有相关单位”。正确解法是分层建模 + 应用层聚合：

✅ 步骤一：正确定义 Eloquent 关系

在 Product.php 模型中定义基础单位关系：

// app/Models/Product.php
public function baseUnit()
{
    return $this->belongsTo(Unit::class, 'unit_id', 'id');
}

在 Unit.php 模型中定义子单位关系（自关联 hasMany）：

// app/Models/Unit.php
public function subUnits()
{
    return $this->hasMany(Unit::class, 'base_unit_id', 'id');
}

这样即可通过预加载高效获取完整层级：

$products = Product::with(['baseUnit.subUnits'])->get();

输出结构为嵌套形式（base_unit → sub_units），符合数据库范式，但不符合前端期望的扁平 units 数组。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

✅ 步骤二：添加聚合访问器（Accessor）

在 Product.php 中新增 units 访问器，将基础单位与子单位合并为 Collection：

// app/Models/Product.php
public function units()
{
    // 防止 N+1 查询，确保 baseUnit 已加载
    if (!$this->relationLoaded('baseUnit')) {
        $this->load('baseUnit.subUnits');
    }

    $baseUnit = $this->baseUnit->replicate(); // 克隆避免污染原始关系
    $baseUnit->unsetRelation('subUnits');      // 移除子单位关系，保持扁平

    return $this->baseUnit->subUnits->merge($baseUnit)->values();
}

? 提示：merge() 合并后顺序为「子单位在前、基础单位在后」；若需基础单位优先，可调换顺序：$baseUnit->subUnits->prepend($baseUnit)->values()

✅ 步骤三：使用方式（支持 Eager Loading + API 输出）

虽然 units 是访问器（非关系），无法直接 with('units')，但可通过 load() 显式加载依赖关系：

$products = Product::with('baseUnit.subUnits')->get();

// 在 API 资源或 toArray() 中使用
return $products->map(function ($product) {
    return [
        'id' => $product->id,
        'name' => $product->name,
        'unit_id' => $product->unit_id,
        'cost' => $product->cost,
        'price' => $product->price,
        'units' => $product->units, // 触发聚合逻辑
    ];
});

或在 ProductResource 中统一处理：

// app/Http/Resources/ProductResource.php
public function toArray($request)
{
    return [
        'id' => $this->id,
        'name' => $this->name,
        'unit_id' => $this->unit_id,
        'cost' => $this->cost,
        'price' => $this->price,
        'units' => UnitResource::collection($this->units),
    ];
}