Laravel：能否基于条件来源填充关联关系？

问题背景 #

遗留代码——现有数据逻辑不在讨论范围内

我在Users和Permissions之间建立了多对多关系，数据库结构如下：

users
    - id
    - email
    - ...

users_permissions
    - user_id
    - permission_id

permissions
    - id
    - name
    - ...

用户有类型区分（管理员、不同权限等级等），规则如下：

• 管理员用户拥有所有权限，但创建时不会在users_permissions生成关联记录
• 当前User模型用的是getter方法而非permissions(): BelongsToMany关联方法
• 这个getter不会把Permission记录存入模型的常规->relations属性中

现有getter代码：

public function getPermissions(): Collection {
    if ($this->type === 'admin') {
        return Permission::all();
    }
    // 非管理员用户
    return UserPermission::with('permissions')
        ->where('user_id', $this->id)
        ->pluck('permission');
}

我想改用常规的permissions()关联方法，这样能支持预加载，类似下面的思路：

public function permissions(): BelongsToMany // 或许可以用联合类型？
{
    if ($this->type === 'admin') {
        // 无关联记录，但拥有所有权限
        $this->setRelation('permissions', Permission::all());
        return /* 返回合适内容 */
    }
    // 普通非管理员用户，使用关联记录
    return $this->belongsToMany(Permission::class, UserPermission::class);
}

有没有合理的实现方式？

解决方案 #

1. 定义标准多对多关联 #

先保留正常的多对多关联，用于处理非管理员用户的权限关联逻辑：

use Illuminate\Database\Eloquent\Relations\BelongsToMany;

public function permissions(): BelongsToMany
{
    return $this->belongsToMany(Permission::class, 'users_permissions');
}

2. 重写访问器兼容管理员逻辑 #

通过重写getPermissionsAttribute访问器，统一处理管理员和普通用户的权限获取，同时兼容Laravel的关联预加载机制：

use Illuminate\Database\Eloquent\Collection;

public function getPermissionsAttribute($value): Collection
{
    // 管理员直接返回所有权限，加入缓存避免重复查询
    if ($this->type === 'admin') {
        return Permission::query()->rememberForever()->get();
    }

    // 非管理员：如果未预加载关联则自动加载，已预加载则直接返回关联数据
    if (! $this->relationLoaded('permissions')) {
        $this->load('permissions');
    }

    return $this->getRelation('permissions');
}

3. 批量预加载优化（可选） #

如果需要批量查询包含管理员的用户集合，可在预加载时统一处理管理员的权限设置，避免单个模型重复查询：

// 查询用户并批量处理权限预加载
$users = User::query()
    ->with('permissions') // 正常预加载非管理员的权限
    ->get()
    ->each(function ($user) {
        if ($user->type === 'admin') {
            // 给管理员批量设置全量权限关联
            $user->setRelation('permissions', Permission::query()->rememberForever()->get());
        }
    });

关键说明 #

不能直接在permissions()关联方法中根据用户类型返回不同逻辑，因为关联方法的核心是定义关系规则，而非返回具体数据。Laravel的预加载机制是基于批量查询实现的，单个模型的判断逻辑无法融入批量流程，会导致预加载失效或异常。

额外优化：缓存更新 #

当权限数据发生变更时，需要手动清除权限缓存以保证数据一致性：

// 更新权限后执行此代码清除缓存
Permission::flushCache();

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