Laravel如何实现多图更新删除及旧图自动清理功能

1. 前置配置：确认模型关联可用 #

首先在rekap模型中配置和图片表的一对多关联，确保可以通过主模型直接调取关联图片数据：

// 在rekap模型文件中添加
public function images()
{
    return $this->hasMany(Image_rekap::class, 'rekap_id');
}

推荐给图片表image_rekaps的rekap_id字段加外键级联删除约束，删除主表数据时数据库会自动清理关联的图片表记录，减少手动代码量：

// 新建迁移文件执行以下外键配置
Schema::table('image_rekaps', function (Blueprint $table) {
    $table->foreign('rekap_id')
        ->references('id')
        ->on('rekaps')
        ->onDelete('cascade');
});

2. 改造删除方法：同步删除关联图片物理文件 #

原有删除逻辑仅删除主表业务数据，需要补充物理文件删除逻辑，替换原有delete_rekap方法代码：

public function delete_rekap($id){
    $data = rekap::findOrFail($id);
    // 遍历所有关联图片，删除本地存储的物理文件
    foreach ($data->images as $img) {
        $filePath = public_path('data_images/'.$img->image);
        if (file_exists($filePath)) {
            unlink($filePath);
        }
    }
    $data->delete();
    return redirect()->route('rekap')->with('success','Data berhasil dihapus');
}

3. 改造更新方法：更新主数据+自动清理旧图 #

原有更新逻辑未处理图片，需要补充新图上传、旧图清理逻辑，替换原有update_rekap方法代码（默认逻辑为：上传新图时自动清空所有旧图，未上传新图则保留原有图片）：

public function update_rekap(Request $request,$id){
    $data = rekap::findOrFail($id);
    // 和新增逻辑保持一致的字段校验，补充图片校验规则
    $validated = $request->validate([
        'customer'=>'required',
        'vessel'=>'required',
        'scopejob'=>'required',
        'pergantian_sparepart'=>'required',
        'teknisi'=>'required',
        'tahun'=>'required',
        'keterangan'=>'required',
        'images'=>'nullable|array',
        'images.*'=>'image|mimes:jpg,jpeg,png|max:2048'
    ]);
    $data->update($validated);

    // 检测到有新图片上传时，先清理旧资源再存储新图
    if($request->has('images')){
        // 删除所有旧图的物理文件
        foreach ($data->images as $oldImg) {
            $oldPath = public_path('data_images/'.$oldImg->image);
            if (file_exists($oldPath)) {
                unlink($oldPath);
            }
        }
        // 清空关联的旧图数据库记录
        $data->images()->delete();

        // 按原有新增逻辑存储新上传的图片
        foreach($request->file('images') as $image){
            $imageName = $validated['customer'].'-image-'.time().rand(1,1000).'.'.$image->extension();
            $image->move(public_path('data_images'),$imageName);
            Image_rekap::create([
                'rekap_id'=>$data->id,
                'image'=>$imageName
            ]);
        }
    }

    return redirect()->route('rekap')->with('success','Data Berhasil di Update');
}

4. 可选扩展：支持单张图片独立删除 #

如果需要在编辑页面单独删除某张旧图、保留其余图片，可以新增单图删除接口：

• 首先添加路由：

Route::get('/delete-single-image/{imgId}', [你的控制器名::class, 'delete_single_image'])->name('image.delete');

• 在控制器中新增对应方法：

public function delete_single_image($imgId)
{
    $img = Image_rekap::findOrFail($imgId);
    // 删除对应物理文件
    $filePath = public_path('data_images/'.$img->image);
    if (file_exists($filePath)) {
        unlink($filePath);
    }
    $img->delete();
    return back()->with('success','Gambar berhasil dihapus');
}

• 最后在编辑页的旧图预览模块，给每张图片添加指向该路由的删除按钮即可。

注意事项

• 所有文件删除操作前必须加file_exists()判断，避免物理文件意外丢失时触发程序报错
• 推荐用findOrFail()替代原生find()方法查询数据，匹配不到记录时会自动返回404响应，无需额外写判断逻辑
• 图片上传建议增加格式、大小校验规则，拦截非法文件上传

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