laravel通过flysystem统一管理文件系统，支持本地、s3、oss等多种存储。在config/filesystems.php中配置多个磁盘，如local、public、s3和oss，每个磁盘对应不同驱动和设置。使用storage门面操作文件，如storage::disk('public')->put()写入文件，storage::disk('s3')->url()获取url。敏感信息应存于.env文件。示例中用户头像存本地public目录，备份日志同步至阿里云oss，实现多存储无缝切换与统一api操作。
在 Laravel 中，Flysystem 是文件系统操作的核心组件，由 Laravel 的文件系统服务提供支持。它基于 League\Flysystem 扩展实现，允许你以统一的 API 操作本地、云存储（如 Amazon S3、阿里云 OSS、腾讯云COS）等不同类型的文件系统。
配置多文件系统驱动
Laravel 的文件系统配置位于 config/filesystems.php 文件中。你可以定义多个磁盘（disk），每个磁盘对应不同的存储驱动和配置。
常见的驱动包括：
- local：本地文件系统
- s3：Amazon S3 或兼容对象存储（如阿里云、腾讯云）
- ftp：FTP 服务器
- public：本地公开可访问目录
示例配置：
'disks' => [
'local' => [
'driver' => 'local',
'root' => storage_path('app'),
],
'public' => [
'driver' => 'local',
'root' => storage_path('app/public'),
'url' => env('APP_URL').'/storage',
'visibility' => 'public',
],
'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'), // 可选，用于私有云或兼容S3的服务
],
'oss' => [
'driver' => 's3',
'key' => env('OSS_ACCESS_KEY'),
'secret' => env('OSS_SECRET_KEY'),
'region' => '',
'bucket' => env('OSS_BUCKET'),
'endpoint' => env('OSS_ENDPOINT'), // 如 https://oss-cn-hangzhou.aliyuncs.com
],
],
使用 Storage 门面操作不同磁盘
Laravel 提供了 Storage 门面来操作文件系统。你可以通过指定磁盘名称切换不同的文件系统。
基本用法：
方科网络ERP图文店
下载
方科网络ERP图文店II版为仿代码站独立研发的网络版ERP销售程序。本本版本为方科网络ERP图文店版的简化版，去除了部分不同用的功能，使得系统更加精炼实用。考虑到图文店的特殊情况，本系统并未制作出入库功能，而是将销售作为重头，使用本系统，可以有效解决大型图文店员工多，换班数量多，订单混杂不清的情况。下单、取件、结算分别记录操作人员，真正做到订单全程跟踪！无限用户级别，不同的用户级别可以设置不同的价
-
Storage::disk('local')->put('file.txt', 'Hello Local');写入本地 -
Storage::disk('s3')->put('file.txt', 'Hello S3');写入 S3 -
Storage::disk('public')->put('avatar.png', $content, 'public');存储公开文件
常用方法：
- put($path, $content)：写入文件
- get($path)：读取文件内容
- exists($path)：判断文件是否存在
- delete($path)：删除文件
- url($path)：获取文件 URL（适用于 s3、public 等支持 URL 的磁盘）
- download($path)：返回文件下载响应
- size($path)：获取文件大小
- mimeType($path)：获取 MIME 类型
实际使用场景示例
假设你需要上传用户头像到本地 public 目录，同时将备份文件上传到阿里云 OSS。
use Illuminate\Support\Facades\Storage;
// 上传头像到本地 public 磁盘
$avatarPath = 'avatars/'.auth()->id().'.png';
Storage::disk('public')->put($avatarPath, $request->file('avatar')->getContent());
// 同步备份日志到 OSS
$logContent = "Backup at ".now();
Storage::disk('oss')->put('backups/log.txt', $logContent);
获取文件 URL：
$url = Storage::disk('s3')->url('files/document.pdf');
echo $url; // 输出: https://your-bucket.s3.region.amazonaws.com/files/document.pdf
环境变量配置建议
将敏感信息如密钥、bucket 名称等放入 .env 文件中更安全：
AWS_ACCESS_KEY_ID=your-key AWS_SECRET_ACCESS_KEY=your-secret AWS_DEFAULT_REGION=us-east-1 AWS_BUCKET=your-bucket AWS_URL=https://s3.us-east-1.amazonaws.com OSS_ACCESS_KEY=your-oss-key OSS_SECRET_KEY=your-oss-secret OSS_BUCKET=your-oss-bucket OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
基本上就这些。Laravel Flysystem 让你在不同存储之间切换变得非常简单，只需调用 disk() 指定磁盘名即可统一操作。只要配置正确，本地、S3、OSS 等都能无缝使用。
