首先配置 S3 存储驱动，安装 AWS SDK 并在 filesystems.php 中设置 s3 驱动，接着在 .env 文件中填写 AWS 凭据；然后在控制器中通过 request()->file() 获取文件，使用 Storage::disk('s3')->store() 将文件上传至 S3，并设置 visibility 为 public 以生成可访问 URL；最后通过前端表单提交文件，确保 enctype 为 multipart/form-data。
在 Laravel 中实现文件上传并存储到 Amazon S3 是一个常见的需求，尤其适用于需要高可用性和可扩展性的项目。Laravel 通过集成 Flysystem 和 AWS SDK，使得上传文件到 S3 变得非常简单。以下是完整的实现步骤。
配置 S3 存储驱动
Laravel 使用 filesystems.php 配置文件来管理不同的存储方式。要使用 S3，需先安装 AWS SDK：
composer require league/flysystem-aws-s3-v3 "^1.0"然后在 config/filesystems.php 中添加或修改 s3 配置：
's3' => [
'driver' => 's3',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION'),
'bucket' => env('AWS_BUCKET'),
'url' => env('AWS_URL'),
'endpoint' => env('AWS_ENDPOINT'), // 可选，用于自定义端点如 MinIO
]
接着在 .env 文件中填写你的 S3 凭据：
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket-name
AWS_URL=https://your-bucket.s3.amazonaws.com
处理文件上传
在控制器中，你可以通过 request()->file() 获取上传的文件，并使用 Storage 门面将其保存到 S3。
示例代码：
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
public function upload(Request $request)
{
$request->validate([
'file' => 'required|file|max:10240', // 最大 10MB
]);
$file = $request->file('file');
$path = $file->store('uploads', 's3'); // 存储到 s3 的 uploads 目录
Storage::disk('s3')->setVisibility($path, 'public'); // 设置为公开访问
$url = Storage::disk('s3')->url($path); // 获取文件 URL
return response()->json([
'message' => '文件上传成功',
'path' => $path,
'url' => $url
]);
}
说明：
- store('uploads', 's3') 将文件保存到 S3 的 uploads 目录下，路径会自动生成。
- setVisibility 设置文件为 public，否则默认是私有的，无法直接通过 URL 访问。
- url($path) 返回文件的公开访问链接。
前端表单提交示例
前端可以使用普通表单或 AJAX 提交文件：
<form action="/upload" method="POST" enctype="multipart/form-data">
@csrf
<input type="file" name="file" required>
<button type="submit">上传</button>
</form>
注意事项与优化建议
- 确保 S3 bucket 的权限策略允许写入和公开读取（如果需要公开访问）。
- 使用预签名 URL 可以实现临时上传权限，增强安全性。
- 对于大文件，考虑使用分片上传或前端直传 S3（通过 STS 临时令牌）。
- 开启 S3 的静态网站托管功能后，可直接通过域名访问文件。
- 本地测试时，可以用 local 驱动代替 s3，便于调试。
基本上就这些。Laravel 的 Storage 系统让对接 S3 非常直观，只要配置正确，几行代码就能完成上传。关键是确保环境变量和权限设置无误。
