答案：composer diag报ext-xxx缺失与镜像无关，只反映PHP CLI环境未启用对应扩展，需用php -m验证、php --ini定位配置文件并启用extension=xxx。
composer diag 说 ext-xxx 缺失，但镜像配置没问题
别被 composer diag 的报错带偏——它压根不测镜像，只检查本地 PHP CLI 环境是否满足基础联网条件（OpenSSL、curl、时间等）。所谓 “ext-zip missing” 或 “ext-mbstring missing”，和你配了阿里云镜像还是腾讯镜像完全无关，是 PHP 自身没加载扩展。
真正要验证的只有两件事：php -m | grep zip 是否输出 zipphp --ini 显示的 Loaded Configuration File 路径下，对应 extension=zip 行是否启用（没被分号注释）
若没启用，改完 ini 文件后必须新开终端再跑 php -m 验证，重启 Apache/Nginx 没用
镜像地址正确，但 composer show 找不到包
这不是 PHP 扩展问题，而是元数据缓存没更新。镜像同步有延迟，composer clear-cache 只清 ZIP 包和 dist 缓存，对 packages.json 和 p/vendor/package.json 这类 provider 元数据几乎无效。
必须手动清理 provider 缓存目录：
先查当前镜像地址：composer config -g repos.packagist.url
再定位缓存路径：ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（Linux/macOS）或 %APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer（Windows）
直接删掉整个目录：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer
之后再跑 composer show vendor/package，Composer 才会强制重拉最新索引
PHP 版本对不上，镜像再快也没用
镜像只是加速下载，不解决环境兼容性。如果 php -v 输出是 7.4，而 composer.json 里写了 "php": "^8.1"，Composer 在解析依赖前就终止，根本不会走到下载那步。
常见陷阱：
终端里 which php 指向旧版本，比如 /usr/bin/php 是 7.4，而新装的 8.2 在 /usr/local/bin/php$PATH 顺序没调好，旧路径排在前面
macOS 上没执行 brew unlink php@7.4 && brew link php@8.2
Docker CI 中 php 和 composer 二进制来自不同 PHP 版本（比如 php 是 8.1，composer 是用 7.4 安装的全局二进制）
换镜像后仍报 TLS 错误或 403
阿里云镜像要求 User-Agent 必须含 Composer 字样，老版本 Composer（低于 1.10.22）可能不满足；另外部分企业 HTTPS 解密代理（如 Zscaler）会替换证书，导致校验失败。
立即学习“PHP免费学习笔记（深入）”；
实操步骤：
先确认 Composer 版本：composer --version，过旧就 composer self-update
强制刷新镜像配置：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾斜杠不能省）
临时绕过证书校验仅限调试：COMPOSER_DISABLE_TLS=1 composer install
更稳妥的是确保系统 curl + OpenSSL 版本足够新，避免 SNI 处理异常（尤其在 Cloudflare 后的 CDN 场景）
镜像配置只是下载通道，真正卡住你的，往往是 PHP CLI 环境本身——扩展没启、版本不对、配置文件错位，这些都和镜像无关，但容易被当成“镜像问题”反复折腾。
