如何在CakePHP中合并批量插入/更新语句以减少数据库交互？

批量插入（单条多值语句） #

如果不需要触发模型的beforeSave/afterSave回调，也不需要自动验证数据，直接用insertMany()方法，它会生成一条包含多条数据的INSERT语句，彻底减少数据库交互次数：

// 准备待插入的关联数组集合
$batchData = [
    ['name' => '商品A', 'price' => 99.9],
    ['name' => '商品B', 'price' => 199.9],
    ['name' => '商品C', 'price' => 299.9]
];

// 执行批量插入
$this->Products->insertMany($batchData);

如果需要先验证数据，可以手动循环验证后再调用insertMany()：

$validatedData = [];
foreach ($batchData as $data) {
    $entity = $this->Products->newEntity($data);
    if ($entity->getErrors()) {
        // 处理验证错误
        continue;
    }
    $validatedData[] = $entity->toArray();
}

$this->Products->insertMany($validatedData);

批量更新/ Upsert（插入或更新） #

批量更新同条件记录

如果要给符合特定条件的多条记录统一更新字段，用updateAll()，生成单条UPDATE语句：

// 将所有库存为0的商品标记为下架
$this->Products->updateAll(
    ['status' => 'out_of_stock'],
    ['stock' => 0]
);

批量Upsert（存在则更新，不存在则插入）

CakePHP 4.1及以上版本支持upsert()方法，基于唯一约束批量处理插入/更新，生成单条带冲突处理的语句（MySQL对应ON DUPLICATE KEY UPDATE，PostgreSQL对应ON CONFLICT DO UPDATE）：

$upsertData = [
    ['id' => 1, 'name' => '更新后的商品A', 'price' => 89.9],
    ['id' => 4, 'name' => '新商品D', 'price' => 399.9]
];

// 以id为唯一约束，存在则更新name和price字段，不存在则插入
$this->Products->upsert($upsertData, ['id'], ['name', 'price']);

为什么save()/saveMany()会生成单独语句 #

save()和saveMany()的设计目标是处理单条记录的完整业务逻辑——包括触发模型回调、自动验证数据、处理关联关系等，所以会为每条记录生成单独的SQL语句。如果单纯追求性能减少数据库往返，优先用上面的批量方法。

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