Laravel多对多关联带level_id的模型配置及层级获取问题

嘿，这个场景我之前在项目里遇到过——当多对多中间表需要关联第三个模型时，单纯用belongsToMany就有点不够用了，咱们得调整一下关联结构，让逻辑更清晰，也能实现你想要的模板调用方式。

第一步：把中间表变成独立模型 #

因为user_facilities现在不仅是关联用户和设施的桥梁，还存了level_id关联等级表，咱们给它创建一个专门的模型UserFacility，这样处理关联会更灵活：

php artisan make:model UserFacility

然后在UserFacility.php里配置三个关联：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class UserFacility extends Model
{
    protected $table = 'user_facilities'; // 明确指定表名，避免Laravel自动推断出错
    protected $fillable = ['user_id', 'facility_id', 'level_id']; // 允许批量赋值的字段

    // 关联用户
    public function user()
    {
        return $this->belongsTo(User::class);
    }

    // 关联设施
    public function facility()
    {
        return $this->belongsTo(Facility::class);
    }

    // 关联设施等级
    public function level()
    {
        return $this->belongsTo(FacilityLevel::class, 'level_id');
    }
}

第二步：调整User和Facility模型的关联 #

原来的belongsToMany可以保留（如果需要兼容旧代码），但新增更清晰的关联来对接UserFacility：

User模型修改：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 保留原有的多对多关联（可选，看你是否需要）
    public function facilities()
    {
        return $this->belongsToMany(Facility::class, 'user_facilities')
                    ->withPivot('level_id'); // 带上level_id字段
    }

    // 新增关联：用户拥有的所有「用户-设施-等级」记录
    public function userFacilities()
    {
        return $this->hasMany(UserFacility::class)
                    ->with(['facility', 'level']); // 预加载设施和等级，避免N+1查询
    }

    // 可选：添加一个快捷方法，获取指定设施的等级
    public function getFacilityLevel($facilityId)
    {
        return $this->userFacilities()
                    ->where('facility_id', $facilityId)
                    ->first()?->level; // 用?避免空指针
    }
}

Facility模型修改：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Facility extends Model
{
    // 保留原有的多对多关联（可选）
    public function users()
    {
        return $this->belongsToMany(User::class, 'user_facilities')
                    ->withPivot('level_id');
    }

    // 新增关联：该设施对应的所有「用户-设施-等级」记录
    public function userFacilities()
    {
        return $this->hasMany(UserFacility::class);
    }
}

第三步：在Blade模板中调用 #

现在你可以轻松遍历用户的所有设施及其等级：

@foreach($user->userFacilities as $userFacility)
    <div>
        设施名称：{{ $userFacility->facility->name }}
        等级属性：{{ $userFacility->level->property }}
    </div>
@endforeach

如果要获取某个特定设施的等级（比如ID为1的设施），可以用我们添加的快捷方法：

{{ $user->getFacilityLevel(1)->property }}

为什么要这么做？ #

把中间表升级为独立模型后，不仅能轻松关联等级表，后续如果要给「用户-设施」关联添加更多字段（比如解锁时间、过期时间），扩展起来也非常方便，比单纯用withPivot要灵活得多。

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