4个Laravel项目如何共用统一存储实现文件上传与下载？

针对你4个Laravel项目需要共用存储、支持全用户文件上传下载的需求，下面提供两种实用方案：

方案一：本地共享目录（适合同服务器/可挂载存储场景） #

这种方案成本低、访问速度快，适合所有项目部署在同一服务器或可通过网络挂载共享存储的环境。

1. 创建统一共享存储目录
   在服务器上创建独立于项目的存储目录，确保所有Laravel运行用户（如www-data）拥有读写权限：

sudo mkdir -p /var/shared-storage
sudo chown -R www-data:www-data /var/shared-storage
sudo chmod -R 755 /var/shared-storage

2. 配置Laravel文件系统
   在每个项目的config/filesystems.php中添加shared磁盘配置：

'disks' => [
    // 保留原有local、public等配置
    'shared' => [
        'driver' => 'local',
        'root' => '/var/shared-storage',
        'url' => env('SHARED_STORAGE_URL', 'http://your-domain.com/shared-storage'),
        'visibility' => 'public',
    ],
],

然后在项目.env文件中设置SHARED_STORAGE_URL，指向共享目录的Web访问地址。

3. 配置Web服务器（以Nginx为例）
   添加Nginx配置，将共享目录映射为静态资源访问路径：

location /shared-storage {
    alias /var/shared-storage;
    expires 30d;
    add_header Cache-Control "public, immutable";
}

重启Nginx使配置生效。

4. 修改上传下载逻辑
   替换原有上传代码，使用shared磁盘存储文件：

// 用户头像上传
$avatarPath = $request->file('avatar')->store('user-avatars', 'shared');

// 学生文件上传
$studentFilePath = $request->file('student_file')->store('student-files', 'shared');

下载或生成访问链接：

// 生成公共访问URL
$avatarUrl = Storage::disk('shared')->url($avatarPath);

// 触发文件下载
return response()->download(Storage::disk('shared')->path($studentFilePath), '学生资料.pdf');

方案二：云存储（适合分布式部署场景） #

如果你的项目部署在不同服务器，使用云存储（如AWS S3、阿里云OSS等）是更可靠的选择，所有项目通过统一的云存储桶实现文件共享。

1. 配置云存储服务
   创建云存储桶，获取访问密钥、区域等信息，确保桶的权限设置符合需求（公开或私有）。

2. 配置Laravel云存储磁盘
   在每个项目的config/filesystems.php中添加云存储磁盘（以AWS S3为例）：

'disks' => [
    // 保留原有配置
    'shared' => [
        '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'),
        'visibility' => 'public',
    ],
],

所有项目使用相同的.env配置项（AWS相关密钥）。

3. 上传下载逻辑
   和本地共享目录的逻辑完全一致，只需指定shared磁盘即可，Laravel会自动处理云存储的API交互。

额外建议 #

• 文件隔离：在共享存储下按项目ID或文件类型创建子目录（如user-avatars/project-1），避免不同项目的文件重名冲突。
• 迁移旧文件：编写脚本将原有public/uploads下的文件批量移动到共享存储，并更新代码中对应的文件引用路径。
• 权限控制：如果需要限制文件访问（如仅特定用户可下载学生文件），可结合Laravel的中间件验证用户权限后再返回文件响应。

内容的提问来源于stack exchange，提问作者Tahir Abbas