ThinkPHP上传自动同步到阿里云OSS或腾讯云COS需安装官方SDK并完整配置驱动参数，使用默认Filesystem接口即可触发云存储上传，无需修改业务代码。
ThinkPHP上传后怎么自动同步到阿里云OSS或腾讯云COS
直接用官方扩展包最稳，别自己手写签名逻辑。ThinkPHP 6.x 默认的 think-filesystem 已内置 OSS/COS 驱动，但需手动装对应适配器并配置——否则上传只存本地，压根不会发请求到云。
- 必须安装对应 SDK 包：
composer require aliyuncs/oss-sdk-php（OSS）或composer require qcloud/cos-sdk-v5（COS） - 配置文件里不能只写
type => 'oss'，还得填全access_key_id、access_key_secret、bucket、endpoint（注意 OSS 的 endpoint 不是控制台首页地址，而是类似https://oss-cn-hangzhou.aliyuncs.com） - 上传代码保持不变：用
$file->move()或Filesystem::putFile()即可，底层会自动走云存储驱动，不改业务逻辑
为什么上传成功但云上没文件？检查这几个点
常见不是代码问题，而是权限或网络卡在中间。尤其内网服务器访问 OSS/COS 时，容易因 DNS 解析失败或安全组拦截静默丢包。
- 看日志里有没有
InvalidAccessKeyId或BucketNotExists错误——说明 AK/SK 写错，或 bucket 名拼错（OSS bucket 全局唯一，大小写敏感） - 执行
curl -v https://your-bucket.oss-cn-hangzhou.aliyuncs.com测试连通性；如果超时，可能是服务器没开外网，得配代理或换内网 endpoint（如oss-cn-hangzhou-internal.aliyuncs.com） - 确认 bucket 的 CORS 配置是否允许你的域名（前端直传才需要），后端上传不用管这个
大文件分片上传要不要自己实现
不用。OSS 和 COS 官方 SDK 都已封装好 resumableUpload（OSS）和 uploadPart（COS），think-filesystem 暂不原生支持，但你可以绕过框架直接调 SDK。
- 场景明确是 >100MB 文件时，别硬用
Filesystem::put()，会内存溢出或超时 - OSS 推荐用
OssClient::multiuploadFile()，传入临时文件路径，SDK 自动分片、重试、合并 - COS 对应用
Qcloud\Cos\Client::uploadPart()+completeMultipartUpload()，注意要自己维护 uploadId - 分片上传的 callback 地址必须能被云服务公网访问，内网环境慎用
本地开发怎么模拟云存储行为
靠切换 filesystem 驱动就行，不需要改一行业务代码。开发时用 local，上线切 oss，靠环境变量隔离。
立即学习“PHP免费学习笔记（深入）”；
- 在
config/filesystem.php里定义多个磁盘，比如'oss' => [...]和'local_dev' => ['root' => runtime_path('upload_test')] - 通过
env('FILESYSTEM_DISK', 'local_dev')控制默认磁盘，不同环境 .env 里设不同值 - 测试时别依赖“云上真有文件”，而是断言
Filesystem::disk('oss')->exists($path)返回 true —— 这个调用会真实发请求，能测通就说明配置生效
真正麻烦的是跨区域复制、生命周期规则、回调鉴权这些，框架不碰，得去云平台后台配，或者调云 API 单独处理。
