不能直接 require aliyun/aliyun-openapi-php-sdk，因该包早已废弃且未发布到packagist；阿里云sdk已按服务拆分为alibabacloud/client（必需）与alibabacloud/oss等独立包，混用新旧包会导致类冲突和签名错误。
为什么不能直接 require aliyun/aliyun-openapi-php-sdk
这个包早已废弃，Packagist 上标记为 abandoned，且从未正式发布。你执行 composer require aliyun/aliyun-openapi-php-sdk 必然失败——不是网络问题，是根本不存在这个合法包名。
阿里云官方 PHP SDK 已按服务拆分，所有新项目必须走统一入口 + 按需加载模式：
-
composer require alibabacloud/client是强制前置依赖，提供认证、签名、重试等基础能力 - 对象存储必须额外加
composer require alibabacloud/oss（非aliyuncs/oss-sdk-php，后者是旧版独立 SDK） - 视频点播、云解析等其他服务同理，用
alibabacloud/vod、alibabacloud/alidns等独立包
混用老包（如 aliyuncs/oss-sdk-php）和新 alibabacloud/* 包会导致类名冲突、签名逻辑不一致，尤其在 Laravel 中易触发 Class not found 或 SignatureDoesNotMatch。
腾讯云 COS 的包名陷阱：qcloud/cos-sdk-v5 已停更
执行 composer require qcloud/cos-sdk-v5 会报 package not found，不是镜像源问题，而是该包自 2021 年起被官方归档，Composer 默认拒绝安装 abandoned 包。
正确做法是切换到迁移后的主干包：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer require cos-php-sdk-v5:^5.7（注意：无qcloud/前缀） - PHP 版本需 ≥7.2，但若用 PHP 8.1+，务必升到
^5.7以上，否则mb_ereg_replace()调用会触发Deprecated报错 - 初始化必须传完整数组：
['secretId' => 'xxx', 'secretKey' => 'yyy', 'region' => 'ap-beijing']，字段名大小写敏感，region值不能含空格或下划线
漏掉 token 字段（STS 临时密钥场景）或写错 region，都会导致上传时返回 SignatureDoesNotMatch，这不是 SDK bug，是签名上下文与后端校验不匹配。
跨云 SDK 封装的关键隔离点：客户端实例与配置分离
别把 OssClientV3、\Qcloud\Cos\Client、\Minio\MinioClient 直接 new 在业务逻辑里。它们的构造参数差异极大：
- 阿里云
alibabacloud/oss：依赖alibabacloud/client的Credentials对象，endpoint 写法为https://oss-cn-hangzhou.aliyuncs.com - 腾讯云
cos-php-sdk-v5：region是独立字段，endpoint 由 SDK 拼接，填ap-beijing即可 - MinIO：
endpoint是完整地址（如192.168.1.100:9000），use_ssl必须显式设为false（HTTP 场景）
封装时应抽象出统一的 upload(string $key, string $content) 和 getPresignedUrl(string $key, int $expires) 接口，把各云厂商的初始化逻辑、错误码映射、重试策略收进工厂类。否则换云时要改遍所有 new 调用点。
镜像源配置失效的三个真实原因
即使你执行了 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，仍可能直连 packagist.org，常见原因有：
- 项目根目录
composer.json含"repositories"字段（哪怕只写了{}），会完全屏蔽全局镜像 - 命令写成
composer config -g repos.packagist（多一个s），新版 Composer 静默忽略 - URL 缺少末尾
/或用了 HTTP 协议（http://），Composer 2.0+ 直接拒用
验证是否生效最准的方式是加 -vvv 运行 composer install，搜日志里的 GET https:// 请求地址——看到的是 mirrors.cloud.tencent.com 才算真生效。项目级配置优先级永远高于全局，这点容易被忽略。
