首先配置 Laravel 文件系统以支持 S3，通过修改 config/filesystems.php 和 .env 文件设置 S3 连接参数，并将默认磁盘设为 s3；接着创建 Blade 上传表单并生成控制器处理文件提交；在控制器中使用 Storage 门面将文件上传至 S3，可设置权限为 public 并获取公开 URL；同时通过 validate() 方法限制文件类型和大小，确保安全；对于大文件，创建 UploadToS3Job 任务类实现异步处理，结合队列提升性能。
如果您在开发 Laravel 应用时需要实现文件上传并将文件存储到 Amazon S3，可能是为了集中管理静态资源或提升应用的可扩展性。Laravel 提供了强大的文件系统支持，结合 Flysystem 可轻松对接 S3 存储。
本文运行环境：MacBook Pro，macOS Sonoma
一、配置 Laravel 的文件系统以支持 S3
该步骤的目的是让 Laravel 能够识别并连接到 Amazon S3 存储服务，通过修改配置文件来指定默认磁盘和 S3 连接参数。
1、打开 config/filesystems.php 文件，找到 disks 数组，并添加或检查 s3 配置项。
2、确保 s3 配置中的 key、secret、region 和 bucket 值为空占位符，实际值将从环境变量中读取。
3、在 .env 文件中设置以下变量：FILESYSTEM_DISK=s3，以便将默认文件磁盘切换为 S3。
4、填写 S3 凭据：AWS_ACCESS_KEY_ID=your_key、AWS_SECRET_ACCESS_KEY=your_secret、AWS_DEFAULT_REGION=us-east-1、AWS_BUCKET=your-bucket-name。
二、创建文件上传表单与控制器
此步骤用于构建前端上传界面并编写后端逻辑处理上传请求，确保文件能正确传递至服务器并转发至 S3。
1、在 resources/views 目录下创建一个 Blade 模板文件 upload.blade.php。
2、在模板中添加表单代码：，包含文件输入字段 。
3、使用 Artisan 命令生成控制器：php artisan make:controller FileController。
4、在 FileController 中定义 store 方法，接收 Request 对象，并使用 $request->file('file') 获取上传的文件。
三、将文件存储到 S3 并设置访问权限
该方法用于将接收到的文件流式上传至 S3，并可选择公开访问或私有保护，满足不同资源的安全需求。
1、在控制器的 store 方法中调用 Storage::disk('s3')->put() 方法，传入目标路径和文件内容。
2、使用 $request->file('file')->get() 或直接使用 putFile() 方法简化操作：Storage::disk('s3')->putFile('uploads', $request->file('file'), 'public')。
3、通过第三个参数设置权限为 public，使文件可通过 URL 公开访问。
4、获取上传后的 URL：Storage::disk('s3')->url($path)，可用于返回给前端展示或保存到数据库。
四、验证上传文件类型与大小限制
为了防止恶意文件上传，必须对客户端提交的文件进行类型和尺寸校验，保障系统安全与稳定性。
1、在控制器中使用 validate() 方法对请求数据进行过滤：$request->validate()。
2、添加规则 'file' => 'required|file|max:10240|mimes:jpg,png,pdf,docx'，限制最大 10MB 并仅允许常见格式。
3、若验证失败，Laravel 将自动重定向并返回错误信息，无需手动处理异常流程。
4、可在 config/filesystems.php 中自定义磁盘选项，如设置 S3 的 ACL 策略或其他元数据。
五、使用队列异步处理大文件上传
对于较大的文件，同步上传可能导致请求超时，使用队列机制可以将上传任务延迟执行，提高响应速度。
1、创建一个任务类：php artisan make:job UploadToS3Job，并在其中注入文件和路径信息。
2、在 job 的 handle 方法中执行与 S3 交互的逻辑，确保 use Illuminate\Support\Facades\Storage。
3、在控制器中分发任务：dispatch(new UploadToS3Job($request->file('file')))。
4、配置 QUEUE_CONNECTION=redis 或 database，并运行队列监听器：php artisan queue:work。
