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 门面来操作文件系统。你可以通过指定磁盘名称切换不同的文件系统。

基本用法：

• 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 等都能无缝使用。