Laravel通过Storage门面实现文件上传管理，需设置表单enctype="multipart/form-data"，使用request()->file()获取文件并调用store()保存至指定磁盘，如public或s3，需运行php artisan storage:link使文件可访问，配置在config/filesystems.php中定义磁盘，支持自定义路径与URL，可通过Storage::url()获取访问链接，exists()判断存在，delete()删除文件，download()下载文件，结合验证与磁盘切换应对各类场景。

在 Laravel 中处理文件上传是开发中常见的需求，比如用户上传头像、附件或图片资源。Laravel 提供了强大的 Storage 门面 来简化文件的存储、读取与管理，支持本地磁盘和云存储（如 AWS S3），让开发者可以轻松实现灵活且可扩展的文件操作。

启用文件上传表单支持

要上传文件，HTML 表单必须设置 enctype="multipart/form-data"，否则文件无法被正确接收。

示例表单：

    @csrf
    
    上传

使用 Storage 门面保存文件

Laravel 的 Storage 门面提供了统一的 API 来操作文件系统。你可以在控制器中通过以下方式处理上传：

• 使用 request()->file('字段名') 获取上传的文件
• 调用 store() 方法将文件保存到指定磁盘目录
• 可指定磁盘（如 local、public、s3）和自定义路径

示例代码：

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

public function upload(Request $request)
{
    if ($request->hasFile('avatar') && $request->file('avatar')->isValid()) {
        // 将文件存储到 public/avatars 目录下，生成唯一文件名
        $path = $request->file('avatar')->store('avatars', 'public');

        // 返回存储路径，可用于保存到数据库
        return response()->json(['path' => $path]);
    }

    return response()->json(['error' => '文件上传失败'], 400);
}

注意：如果使用 public 磁盘，需运行 php artisan storage:link 创建软链接，使文件可通过 Web 访问。

文件存储配置与磁盘管理

Laravel 的文件系统配置位于 config/filesystems.php，你可以定义多个“磁盘”，例如：

• local：存储在 storage/app，默认不公开
• public：存储在 storage/app/public，可通过软链接公开访问
• s3：上传至 Amazon S3，适合生产环境

你也可以自定义磁盘，比如：

'uploads' => [
    'driver' => 'local',
    'root' => storage_path('app/uploads'),
    'url' => env('APP_URL').'/uploads',
    'visibility' => 'public',
],

然后在代码中使用：Storage::disk('uploads')->store(...)

获取文件 URL 与删除文件

上传后常需要返回文件访问地址或提供删除功能。

• 获取 URL：Storage::url('avatars/filename.jpg')
• 判断文件是否存在：Storage::exists('path/to/file')
• 删除文件：Storage::delete('avatars/old.jpg')
• 下载文件：return Storage::download('files/report.pdf');

这些方法让文件管理更加灵活安全。

基本上就这些。结合验证、目录隔离和磁盘切换，Laravel 的 Storage 门面足以应对大多数文件上传与管理场景，既简洁又强大。