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 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 门面足以应对大多数文件上传与管理场景，既简洁又强大。
