ThinkPHP 6.0 需通过环境变量切换本地与云存储，配置 filesystem.php 的 default 为 env('FILESYSTEM_DISK', 'local')，并分别配置七牛云（用 overtrue/flysystem-qiniu）和阿里云 OSS（用 thans/thinkphp-filesystem-cloud），上传时构造非根路径、流式读取内容并统一调用 Filesystem::disk()。
ThinkPHP 6.0 项目上线后流量增长，本地存储撑不住图片、视频等静态资源访问压力，需将文件存储无缝迁移到七牛云或阿里云 OSS，同时保留本地开发调试能力，不改业务代码逻辑。
确认当前存储架构是否支持多磁盘切换
打开 config/filesystem.php，检查 'default' 配置项是否为环境变量驱动：'default' => env('FILESYSTEM_DISK', 'local')。不是则手动改为该写法——否则无法通过 .env 切换磁盘，后续所有云同步配置都白配。
确认 'disks' 数组中已定义 'local' 磁盘，且其 'root' 指向 runtime/storage 或 public/storage，这是开发阶段的兜底路径。
接入七牛云：用 overtrue/flysystem-qiniu 替换废弃驱动
方法一：安装兼容 TP6 的官方适配器
立即学习“PHP免费学习笔记（深入）”；
执行命令：composer require overtrue/flysystem-qiniu。不要装 league/flysystem-qiniu——它已废弃，会导致 bucket 校验失败或签名过期。
方法二：配置必须字段（缺一不可）
在 config/filesystem.php 的 'disks' 中追加：
'qiniu' => [ 'type' => 'qiniu', 'accessKey' => env('QINIU_ACCESS_KEY'), 'secretKey' => env('QINIU_SECRET_KEY'), 'bucket' => env('QINIU_BUCKET'), // 全小写，不含 -z2 或 cn-east-1 'domain' => env('QINIU_DOMAIN'), // 如 https://cdn.example.com，结尾<strong>【不能带 /】</strong> 'region' => env('QINIU_REGION', 'z2'), // 华南填 z2，华东填 z1 'useHttps' => true,],
注意：region 值必须与七牛控制台空间所在区域严格对应，填错会导致上传 403；domain 必须是已在七牛后台完成备案并绑定该 bucket 的 CDN 域名。
对接阿里云 OSS：避开临时文件陷阱
第一步：安装合规扩展
运行：composer require thans/thinkphp-filesystem-cloud。别手写 OSS 驱动——【直接调用 OssClient::uploadFile() 会因 PHP-FPM 清理临时文件而失败】，错误提示常为 “No such file or directory” 或 “Empty file”。
第二步：配置四项硬性参数
在 config/filesystem.php 中添加：
'aliyun' => [ 'type' => 'aliyun', // 不是 'oss' 或 'aliyuncs' 'accessId' => env('OSS_ACCESS_ID'), 'accessSecret' => env('OSS_ACCESS_SECRET'), 'bucket' => env('OSS_BUCKET'), // 区分大小写，与控制台完全一致 'endpoint' => env('OSS_ENDPOINT'), // 必须含 https://，如 https://oss-cn-beijing.aliyuncs.com 'url' => env('OSS_URL'), // 对外访问地址，如 http://my-bucket.oss-cn-beijing.aliyuncs.com，<strong>【结尾严禁加 /】</strong>],
上传逻辑改造：统一适配云/本地双模式
① 获取上传文件对象：$file = $this->request->file('avatar');
② 判断是否为真实文件（防止空上传）：if (!$file || !$file->isValid()) { throw new Exception('上传文件无效'); }
③ 构造存储路径（关键：路径不能以 / 开头）：$key = 'uploads/' . date('Y-m-d') . '/' . uniqid() . '.' . $file->getExtension();
④ 流式读取内容，绕过内存加载：$content = file_get_contents($file->getRealPath());。若在 Swoole 环境中 getRealPath() 返回 false，则 fallback 为 $file->read()。
⑤ 执行上传：Filesystem::disk(env('FILESYSTEM_DISK', 'local'))->put($key, $content);
