Laravel中如何实现不解除关联并同步设置pivot字段值？

要实现「添加指定角色、不解除现有角色关联、同时给新增角色设置active为true」的需求，有以下几种实用方法：

方法一：直接使用syncWithPivotValues并关闭解除关联 #

Laravel的syncWithPivotValues方法支持第三个可选参数$detaching（默认值为true），将其设为false即可实现不解除现有关联，同时为指定角色设置pivot值：

$user->roles()->syncWithPivotValues([1, 2, 3], ['active' => true], false);

这个方法本质上是sync方法的封装，第三个参数控制是否移除不在指定ID列表中的关联，设为false就和syncWithoutDetaching的行为一致，同时完成pivot值的设置。

方法二：封装自定义关联方法 #

如果觉得参数不够直观，可以在模型中封装一个语义化的自定义方法，方便后续调用：

方式1：在User模型中添加快捷方法 #

class User extends Model
{
    public function roles()
    {
        return $this->belongsToMany(Role::class)->withPivot('active');
    }

    /**
     * 同步角色（不解除现有）并设置新增角色的pivot值
     */
    public function syncRolesWithoutDetachingWithPivot(array $roleIds, array $pivotValues)
    {
        return $this->roles()->syncWithPivotValues($roleIds, $pivotValues, false);
    }
}

调用时直接使用自定义方法：

$user->syncRolesWithoutDetachingWithPivot([1, 2, 3], ['active' => true]);

方式2：扩展BelongsToMany类实现通用方法 #

如果多个关联都需要这个功能，可以扩展Laravel的BelongsToMany类，添加通用方法：

use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class CustomBelongsToMany extends BelongsToMany
{
    /**
     * 同步关联（不解除现有）并设置pivot值
     */
    public function syncWithoutDetachingWithPivotValues($ids, array $pivotValues)
    {
        return $this->syncWithPivotValues($ids, $pivotValues, false);
    }
}

然后在模型中重写newBelongsToMany方法，使用自定义关联类：

class User extends Model
{
    protected function newBelongsToMany($query, $parent, $table, $foreignPivotKey, $relatedPivotKey, $parentKey, $relatedKey, $relationName = null)
    {
        return new CustomBelongsToMany($query, $parent, $table, $foreignPivotKey, $relatedPivotKey, $parentKey, $relatedKey, $relationName);
    }

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

之后就可以像你期望的那样直接调用：

$user->roles()->syncWithoutDetachingWithPivotValues([1, 2, 3], ['active' => true]);

方法三：仅为新增角色设置Pivot值 #

如果不需要触发现有角色的任何操作，只想给用户没有的角色添加并设置pivot值，可以先筛选出未关联的角色ID，再用attach方法：

// 获取用户已关联的角色ID
$existingRoleIds = $user->roles()->pluck('roles.id')->toArray();
// 筛选出需要新增的角色ID
$newRoleIds = array_diff([1, 2, 3], $existingRoleIds);

if (!empty($newRoleIds)) {
    // 为每个新增角色设置pivot值
    $attachData = array_combine(
        $newRoleIds,
        array_fill(0, count($newRoleIds), ['active' => true])
    );
    $user->roles()->attach($attachData);
}

这个方法只会对新增角色执行中间表插入操作，性能更优，适合不需要更新现有角色pivot值的场景。

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