Laravel通过Flysystem实现文件上传管理，流程包括表单设置enctype、控制器接收文件、验证及存储。配置在config/filesystems.php中定义磁盘，如local、public或S3云存储，使用store()保存文件并生成访问路径。需运行php artisan storage:link使public磁盘可访问，支持通过Storage::url()生成URL，私有文件应通过控制器安全返回。

Laravel 提供了强大且灵活的文件系统来处理文件上传和存储管理。通过集成 Flysystem 文件系统，开发者可以轻松地将文件保存到本地磁盘、云存储（如 Amazon S3、阿里云 OSS）等位置。本文将介绍 Laravel 中文件上传的基本流程、配置方式以及最佳实践。

文件上传基本流程

在 Laravel 中处理文件上传通常包括接收请求中的文件、验证文件类型与大小、将其存储到指定位置，并记录路径或其他信息。

示例代码：

public function upload(Request $request)
{
    $request->validate([
        'avatar' => 'required|image|mimes:jpeg,png,jpg|max:2048',
    ]);

    if ($request->hasFile('avatar')) {
        $path = $request->file('avatar')->store('avatars', 'public');
        // 返回存储路径，例如：avatars/abc123.png
        return response()->json(['path' => $path]);
    }

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

文件系统配置（config/filesystems.php）

Laravel 的文件系统配置位于 config/filesystems.php，支持多种驱动：local、s3、ftp、oss 等。

创建软链接命令：

php artisan storage:link

执行后，访问 http://your-app.com/storage/avatars/abc.png 即可查看上传的文件。

使用云存储（以 S3 为例）

若要使用 Amazon S3 或兼容服务（如阿里云 OSS），需安装 Flysystem 扩展包：

composer require league/flysystem-aws-s3-v3 "^3.0"

然后在 .env 中配置：

FILESYSTEM_DISK=s3
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket
AWS_ENDPOINT=https://s3.your-region.amazonaws.com

上传时指定磁盘即可：

$request->file('video')->store('videos', 's3');

文件访问与 URL 生成

已存储的文件可通过 Storage 门面获取 URL：

use Illuminate\Support\Facades\Storage;

$url = Storage::url('avatars/abc123.png'); 
// 生成 /storage/avatars/abc123.png（适用于 public 磁盘）

$s3Url = Storage::disk('s3')->url('files/document.pdf');
// 生成完整的 S3 公共链接

注意：私有文件不应暴露 URL，应通过控制器动态返回内容：

return Storage::download('private/invoice.pdf'); // 强制下载
// 或
return response()->file(Storage::path('preview.jpg'));