Laravel Eloquent多对多关系中如何访问指定中间表

场景说明 #

我定义了Product模型，同一商品可被多个Supermarket和Outlet售卖，因此在Product中设置了两个多对多关联：

class Product extends Model
{
    public function supermarkets(): BelongsToMany
    {
        return $this->belongsToMany(
            Supermarket::class,
            'product_supermarket',
            'product_id',
            'supermarket_id'
        );
    }

    public function outlets(): BelongsToMany
    {
        return $this->belongsToMany(
            Outlet::class,
            'outlet_product',
            'product_id',
            'outlet_id'
        );
    }
}

同时在Supermarket模型中也定义了和Product的多对多关联：

class Supermarket extends Model
{
    public function products(): BelongsToMany
    {
        return $this->belongsToMany(
            Product::class,
            'product_supermarket',
            'supermarket_id',
            'product_id'
        );
    }
}

从Supermarket访问关联商品时，能通过$product->pivot获取product_supermarket中间表数据，但从Product出发有两个多对多关联，想知道怎么分别访问两个中间表的数据。

解决方案 #

1. 默认方式直接访问

pivot属性是和当前关联关系绑定的，不同的关联对应各自的中间表：

• 当访问$product->supermarkets时，每个Supermarket实例的pivot对应product_supermarket中间表的数据
• 当访问$product->outlets时，每个Outlet实例的pivot对应outlet_product中间表的数据

代码示例：

// 获取product_supermarket中间表数据
foreach ($product->supermarkets as $supermarket) {
    echo $supermarket->pivot->created_at;
}

// 获取outlet_product中间表数据
foreach ($product->outlets as $outlet) {
    echo $outlet->pivot->created_at;
}

2. 自定义pivot别名（可选，更清晰）

如果觉得默认的pivot名称不够直观，可以在定义关联时用as()方法给中间表数据起别名，避免混淆：
修改Product模型的关联定义：

class Product extends Model
{
    public function supermarkets(): BelongsToMany
    {
        return $this->belongsToMany(
            Supermarket::class,
            'product_supermarket',
            'product_id',
            'supermarket_id'
        )->as('product_supermarket_pivot'); // 自定义pivot别名
    }

    public function outlets(): BelongsToMany
    {
        return $this->belongsToMany(
            Outlet::class,
            'outlet_product',
            'product_id',
            'outlet_id'
        )->as('outlet_product_pivot'); // 自定义pivot别名
    }
}

之后访问时就可以用自定义的别名：

foreach ($product->supermarkets as $supermarket) {
    echo $supermarket->product_supermarket_pivot->created_at;
}

foreach ($product->outlets as $outlet) {
    echo $outlet->outlet_product_pivot->created_at;
}

3. 注意：指定要获取的中间表字段

如果需要访问中间表的额外字段（比如created_at、price等），必须在关联定义中用withPivot()明确指定这些字段，否则无法通过pivot获取：

public function supermarkets(): BelongsToMany
{
    return $this->belongsToMany(
        Supermarket::class,
        'product_supermarket',
        'product_id',
        'supermarket_id'
    )->withPivot('created_at', 'price'); // 指定需要获取的中间表字段
}

内容的提问来源于stack exchange，提问作者kykywei