Laravel Eloquent多对多关联中如何为指定用户分配多个角色

假设你已经完成User模型与Role模型的多对多关联配置、中间表结构搭建，可根据实际业务场景选择对应方法补全代码逻辑。

前置确认：User模型中必须存在多对多关联方法定义，示例如下（你应该已经完成该配置）：

public function roles()
{
    return $this->belongsToMany(Role::class);
}

不同业务场景的代码实现 #

场景1：追加角色，保留用户原有已分配角色 #

如果不需要覆盖用户之前的角色，仅新增关联，推荐使用syncWithoutDetaching方法（自动去重，不会插入重复关联记录）：

$user = User::find(2);
// 传入需要分配的角色ID数组，支持单个ID、ID数组、Role模型实例/模型集合
$assignRoleIds = [1, 3, 5];
$user->roles()->syncWithoutDetaching($assignRoleIds);
// 也可使用attach方法，但该方法不会校验重复关联，重复调用会插入重复的中间表数据
// $user->roles()->attach($assignRoleIds);
return view('index', compact('user'));

场景2：同步角色，仅保留本次传入的角色关联 #

这是角色分配功能最常用的逻辑，调用sync方法后，用户最终只会和传入的角色ID建立关联，之前存在但不在本次传入列表中的关联会被自动删除：

$user = User::find(2);
// 同步后该用户仅关联ID为2、4、6的角色
$assignRoleIds = [2, 4, 6];
$user->roles()->sync($assignRoleIds);

// 如果中间表有额外字段（比如角色过期时间），可以用关联数组传参
// $user->roles()->sync([
//     2 => ['expire_at' => now()->addYear()],
//     4 => ['expire_at' => now()->addYear()],
//     6 => ['expire_at' => now()->addYear()]
// ]);
return view('index', compact('user'));

场景3：移除用户的指定角色 #

如果需要删除用户已绑定的部分角色，使用detach方法：

$user = User::find(2);
// 移除单个角色（比如ID为3的角色）
$user->roles()->detach(3);
// 移除多个角色传入数组即可
// $user->roles()->detach([3,5]);
// 不传参数会移除该用户所有已分配的角色
// $user->roles()->detach();
return view('index', compact('user'));

多对多关联写入方法区别 #

• attach()：直接新增中间表关联记录，不做重复校验，不删除已有记录
• detach()：删除指定的中间表关联记录，不传参时删除当前模型的所有关联记录
• sync()：全量同步关联，传入的ID数组为最终生效的关联列表，列表外的已有关联会被自动清除，自带去重逻辑
• syncWithoutDetaching()：增量追加关联，仅新增列表中不存在的关联记录，不删除已有关联，自带去重逻辑

视图中可以直接通过$user->roles获取分配完成后的用户角色集合，无需额外查询。

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