Laravel中更新数据库图片数组字段时如何保留旧值并追加新上传图片？

安全阿岳

2026-10-8

#Laravel图片上传数组追加不覆盖解决方案

核心问题原因

原有代码每次仅将新上传的图片生成新数组直接写入数据库，没有读取已有图片数组做合并，因此会覆盖旧数据。

前置配置确认

首先确保Product模型中已经对images字段做了数组类型转换，Laravel会自动处理字段的JSON序列化/反序列化，无需手动转换格式：

// app/Models/Product.php
class Product extends Model
{
    protected $casts = [
        'images' => 'array', // 必须配置该项
    ];
}

修改后业务代码

$product = Product::query()->where('title', '=', $data['title'])->first();
if($request->has('product_images')) {
    // 优先读取产品原有图片数组，无历史数据则初始化为空数组
    $images = $product?->images ?? [];

    foreach ($request->product_images as $productImage) {
        $file = $productImage;
        $slug = Str::slug($data['title']);
        $savePath = storage_path("/app/public/products/images/{$slug}/");

        // 自动创建不存在的存储目录，避免文件移动失败
        if (!file_exists($savePath)) {
            mkdir($savePath, 0755, true);
        }

        $fileName = $file->getClientOriginalName();
        // 可选：处理重名文件，避免同文件名覆盖本地已存图片
        if (file_exists($savePath . $fileName)) {
            $name = pathinfo($fileName, PATHINFO_FILENAME);
            $ext = $file->getClientOriginalExtension();
            $fileName = "{$name}_" . time() . ".{$ext}";
        }

        $file->move($savePath, $fileName);
        $images[] = ['img' => $fileName];
    }

    if($product) {
        // 合并后的数组更新，不会覆盖原有数据
        $product->update(['images' => $images]);
    }
}