Laravel中如何更新项目slug对应存储文件夹名称并保留文件？

一、创建项目时生成同名文件夹 #

当你创建新项目时，咱们可以利用Laravel模型的创建事件，在项目成功创建后自动生成和Slug同名的文件夹。

首先，在你的Project模型中添加模型事件监听，同时整合自动生成Slug的逻辑：

use Illuminate\Support\Facades\Storage;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Str;

class Project extends Model
{
    protected static function boot()
    {
        parent::boot();

        // 创建前自动生成Slug
        static::creating(function ($project) {
            if (empty($project->slug)) {
                $project->slug = Str::slug($project->title);
            }
        });

        // 项目创建完成后生成对应文件夹
        static::created(function ($project) {
            // 定义文件夹存储路径（这里以public磁盘下的projects目录为例）
            $folderPath = "projects/{$project->slug}";
            
            // 创建文件夹，第二个参数为true表示允许创建多级嵌套目录
            Storage::makeDirectory($folderPath);
        });
    }
}

二、更新项目时同步重命名文件夹 #

当编辑项目标题导致Slug更新时，咱们需要在更新事件中检查Slug是否发生变化，若有变化则重命名对应文件夹并保留内部文件。

继续在Project模型的boot方法中添加更新事件监听：

static::updating(function ($project) {
    // 检查slug字段是否被修改
    if ($project->isDirty('slug')) {
        $oldSlug = $project->getOriginal('slug');
        $newSlug = $project->slug;

        // 确保旧Slug存在且和新Slug不同
        if ($oldSlug && $oldSlug !== $newSlug) {
            $oldFolderPath = "projects/{$oldSlug}";
            $newFolderPath = "projects/{$newSlug}";

            // 先校验旧文件夹是否存在
            if (Storage::exists($oldFolderPath)) {
                // 避免目标文件夹已存在导致覆盖
                if (!Storage::exists($newFolderPath)) {
                    try {
                        // 执行文件夹重命名操作
                        Storage::move($oldFolderPath, $newFolderPath);
                    } catch (\Exception $e) {
                        // 处理重命名失败的情况：记录日志或根据业务需求抛出异常
                        \Log::error('项目文件夹重命名失败: ' . $e->getMessage());
                        // 若需要阻止项目更新，可取消下面注释抛出异常
                        // throw new \Exception('文件夹重命名失败，请稍后重试');
                    }
                } else {
                    \Log::warning('目标文件夹已存在，无法重命名: ' . $newFolderPath);
                }
            }
        }
    }
});

三、关键注意事项 #

• 权限配置：确保存储目录（如storage/app/public）拥有正确的读写权限，避免创建/重命名文件夹失败。
• Slug唯一性：建议在数据库的slug字段添加唯一约束，防止多个项目生成相同Slug引发文件夹冲突。
• 多磁盘适配：如果使用云存储（如S3），只需在Storage方法中指定磁盘参数即可，例如Storage::disk('s3')->makeDirectory(...)。
• 异常处理：根据业务场景调整异常逻辑，比如是否在文件夹操作失败时终止项目更新，还是仅记录日志后续处理。

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