不删除旧条目且设置关联表特定pivot字段值的Eloquent sync实现

我明白你要做的是在多对多关联中，执行类似sync的操作但保留所有旧关联，同时给旧关联的status字段设置特定值。下面是具体的实现方案，结合Laravel Eloquent的特性来完成：

第一步：确保模型关联正确定义 #

首先要在Customer模型中明确关联，并且指定要操作的pivot字段status：

class Customer extends Model
{
    public function products()
    {
        return $this->belongsToMany(Product::class)
            ->withPivot('status') // 声明要使用的pivot字段
            ->withTimestamps(); // 如果关联表有时间戳字段就加上，没有可以省略
    }
}

第二步：自定义Sync逻辑 #

默认的sync()方法会删除不在给定数组中的关联，我们需要修改这个行为，同时更新旧关联的pivot值。这里分两种场景处理：

场景1：将所有旧关联（无论是否在新数组中）的status设为特定值 #

比如你想把所有已存在的关联的status设为0，然后添加新关联并设置status为1：

// 假设$customer是你的Customer实例，$newProductIds是要关联的新product ID数组
$customer = Customer::find($customerId);
$newProductIds = [2, 3, 5]; // 示例ID数组

// 1. 更新所有已存在的关联的status字段
$customer->products()->newPivotStatement()
    ->where('customer_id', $customer->id)
    ->update(['status' => 0]);

// 2. 执行不删除旧关联的sync操作，同时设置新关联的status为1
$customer->products()->sync(
    collect($newProductIds)->mapWithKeys(function ($id) {
        return [$id => ['status' => 1]];
    })->toArray(),
    false // 关键参数：设为false表示不删除不在$newProductIds中的关联
);

场景2：仅将不在新数组中的旧关联的status设为特定值 #

如果你只想把不在本次sync数组里的旧关联标记为失效（比如status=0），而在数组里的关联（无论新旧）保持有效（status=1），可以这样做：

$customer = Customer::find($customerId);
$newProductIds = [2, 3, 5];

// 1. 获取当前已关联的所有product ID
$existingIds = $customer->products()->pluck('product_id')->toArray();

// 2. 筛选出不在新数组里的旧关联ID，更新它们的status
$oldIdsToUpdate = array_diff($existingIds, $newProductIds);
if (!empty($oldIdsToUpdate)) {
    $customer->products()->newPivotStatement()
        ->where('customer_id', $customer->id)
        ->whereIn('product_id', $oldIdsToUpdate)
        ->update(['status' => 0]);
}

// 3. 执行sync，不删除旧关联，同时设置数组内关联的status为1
$customer->products()->sync(
    collect($newProductIds)->mapWithKeys(function ($id) {
        return [$id => ['status' => 1]];
    })->toArray(),
    false
);

关键知识点说明 #

• sync($array, false)：第二个参数$detaching默认是true，设为false就会保留所有不在$array中的关联，只添加/更新数组内的关联。
• newPivotStatement()：直接操作关联表的查询构造器，避免N+1查询，批量更新效率更高。
• 如果只想添加新关联而不更新已存在的关联的pivot值，可以用syncWithoutDetaching()替代sync(..., false)，但它不会修改已存在关联的pivot字段。

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