Laravel中利用cascadeOnDelete删除文件夹时如何删除关联物理文件？

1. 定义模型关联 #

在Folder模型中添加与File的一对多关联：

// app/Models/Folder.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Folder extends Model
{
    public function files(): HasMany
    {
        return $this->hasMany(File::class);
    }
}

2. 利用模型deleting事件处理物理文件删除 #

直接在Folder模型的boot方法中注册删除前事件，在文件夹记录删除前遍历关联文件，删除对应的物理文件：

// app/Models/Folder.php
use Illuminate\Support\Facades\Storage;

protected static function boot()
{
    parent::boot();

    static::deleting(function ($folder) {
        // 遍历当前文件夹下的所有关联文件
        $folder->files->each(function ($file) {
            // 验证文件路径存在且物理文件存在，再执行删除
            if ($file->path && Storage::exists($file->path)) {
                Storage::delete($file->path);
            }
        });
    });
}

关键注意点 #

• 若file.path存储的是服务器完整物理路径（而非Storage的相对路径），需替换为File facade操作：

  use Illuminate\Support\Facades\File;
  
  if ($file->path && File::exists($file->path)) {
      File::delete($file->path);
  }
  

• 确认config/filesystems.php中本地存储的根路径配置正确，确保Storage能定位到文件。
• 若使用软删除（SoftDeletes trait），需根据需求调整事件：软删除触发deleting，永久删除触发forceDeleted，可针对性注册事件。

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