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”，否则文件无法被正确接收。
示例表单：
<form action="/upload" method="POST" enctype="multipart/form-data"> @csrf <input type="file" name="avatar"> <button type="submit"> 上传 </button> </form>使用 Storage 门面保存文件
Laravel 的 Storage 门面提供了统一的 API 来操作文件系统。你可以在控制器中通过以下方式处理上传：
- 使用 request()->file(‘ 字段名 ’) 获取上传的文件
- 调用 store() 方法将文件保存到指定磁盘目录
- 可指定磁盘（如 local、public、s3）和自定义路径
示例代码：
use IlluminateHttpRequest; use IlluminateSupportFacadesStorage; 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 门面足以应对大多数文件上传与管理场景，既简洁又强大。
以上就是 Laravel 如何处理文件上传_Laravel Storage 门面实现文件存储与管理的详细内容，更多请关注 php 中文网其它相关文章！
