如何让Laravel Media Library将文件保存到指定的avatars文件夹？

要让文件保存到avatars文件夹而非默认的数字命名文件夹，有两种常用方案：

方案一：在模型中全局配置媒体集合（推荐） #

在你的User模型中注册avatars媒体集合时，直接指定存储路径，这样所有通过toMediaCollection('avatars')添加的文件都会自动存到目标文件夹：

use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;
use Spatie\MediaLibrary\MediaCollections\Models\Media;

class User extends Model implements HasMedia
{
    use InteractsWithMedia;

    public function registerMediaCollections(): void
    {
        $this->addMediaCollection('avatars')
            // 可选：指定存储磁盘，默认使用filesystems.php中配置的默认磁盘
            ->useDisk('public')
            // 设置固定存储路径
            ->usePathGenerator(function (Media $media) {
                return 'avatars/';
            });
    }
}

配置后，原代码无需修改，调用toMediaCollection('avatars')时文件就会存入storage/app/public/avatars（如果使用public磁盘）。

方案二：单次添加媒体时指定路径 #

如果只需要在特定场景下指定路径，可以在添加媒体时链式调用storePath方法：

// Avatar image
if ($request->hasFile('avatar')) {
    $user->addMediaFromRequest('avatar')
        ->storePath('avatars')
        ->toMediaCollection('avatars');
}

注意事项 #

• 确保已运行php artisan storage:link生成软链接，这样前端才能访问storage/app/public下的文件。
• 如果使用自定义磁盘，需在config/filesystems.php中提前配置好磁盘参数。

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