腾讯云PHP SDK安装卡在Downloading，根本原因是Composer未正确切换至腾讯云镜像源；必须严格执行composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，确保键名、type值、URL末尾斜杠三者全部正确，并通过composer config -g repo.packagist、clear-cache和-vvv日志三步验证是否生效。
腾讯云PHP SDK安装卡在Downloading，不是SDK问题，是源没换对
腾讯云PHP SDK本身不慢，慢的是Composer默认从packagist.org拉元数据和索引。一旦你执行composer require tencentcloud/sdk后卡在Downloading几十秒不动，基本可以确定：镜像根本没生效，或者只换了一半。
常见错误现象包括：Could not fetch https://mirrors.cloud.tencent.com/composer/p2/tencentcloud%2Fsdk.json（404）、Failed to decode response、或日志里反复出现packagist.org域名。这些都不是SDK包本身的问题，而是Composer压根没走腾讯云镜像。
-
repo.packagist键名写成repos.packagist（多一个s）→ 静默忽略，配置白写 - URL漏掉末尾
/→ 拼出https://mirrors.cloud.tencent.com/composer/packages.json变成404 - 用了已停用地址如
https://packagist.phpcomposer.com→ 2025年底已下线，现在返回空响应或重定向失败 - 项目级
composer.json里写了"repositories"块 → 会100%覆盖全局配置，镜像失效
配腾讯云镜像必须用这条命令，少一个字符都不行
真正起效的命令只有一条，且必须严格复制粘贴：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
注意三个硬性要求：
立即学习“PHP免费学习笔记（深入）”；
腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。
- 键名是
repo.packagist（不是repos，不是repositories） -
composer是type字段值，必须显式写出，不能省略 - URL必须以
https://开头，且结尾必须带/
Windows用户需以管理员身份运行终端；macOS/Linux注意~/.composer/config.json目录权限是否可写。如果报proc_open(): fork failed，说明PHP禁用了proc_open或putenv，要检查php.ini里的disable_functions并重启PHP服务。
配完不验证=没配，三步确认法缺一不可
执行完命令后，立刻验证，别急着装SDK：
- 运行
composer config -g repo.packagist，输出必须是{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}或新版仅显示该URL字符串——如果为空、为旧地址、或仍是{"type":"composer","url":"https://packagist.org"}，说明配置失败 - 运行
composer clear-cache，看到两行Clearing cache (cache-dir):和Clearing cache (cache-vcs):才算成功；否则缓存仍指向海外源 - 运行
composer install -vvv（哪怕当前目录没composer.json也行），滚动日志最后几行必须出现https---mirrors-cloud-tencent-com-composer字样；如果看到https---packagist-org，就是fallback了
装腾讯云SDK时还慢？可能卡在ZIP直链下载，镜像不负责这部分
腾讯云镜像只代理packages.json和p2/索引文件，真正的SDK ZIP包仍从GitHub/GitLab直链下载。所以如果你卡在Downloading tencentcloud/sdk这一步，问题不在镜像配置，而在：
- 本地网络是否能直连GitHub（比如公司防火墙拦截）
- 是否启用了
openssl和zlib扩展（php -m | grep -E 'openssl|zlib'） - 是否开了代理但没配好
http-proxy（composer config -g --unset http-proxy可临时清掉）
这时候换镜像没用，得查curl -I https://github.com/tencentcloud/tencentcloud-sdk-php/releases/download/v3.0.1017/tencentcloud-sdk-php.zip是否通。镜像只解决“找包”阶段，不解决“下包”阶段——这点最容易被忽略。
