中文镜像不感知PHP版本且只缓存代理Packagist元数据，所谓兼容性问题多因本地PHP/Composer版本与镜像源配置错位所致；composer self-update显示“Up to date”是因镜像缓存了官方版本检查响应，需先切回官方源升级再换回镜像；PHP版本报错实为Composer调用的PHP解释器路径与php -v不一致，应通过composer diagnose确认并修复PATH或显式指定PHP路径；config.platform.php仅影响依赖解析，需配合composer update --lock更新lock文件，镜像本身不校验platform合理性；CI中使用镜像+platform时须确保构建环境真装对应PHP版本；真正影响安装的是php解释器加载路径、lock文件解析结果及是否清理vendor目录。
中文镜像本身不感知 PHP 版本，它只缓存和代理 Packagist 的元数据；所谓“兼容性问题”，99% 是你本地 PHP 版本、Composer 版本、镜像源配置三者错位导致的误判或失败。
为什么 composer self-update 在中文镜像下总显示 “Up to date”
这不是网络慢，也不是镜像不更新，而是镜像把 Composer 官方的版本检查响应（https://getcomposer.org/version）也缓存了。你看到的 “Up to date” 是镜像返回的旧响应，不是你本地真没新版本。
- 必须先切回官方源：
composer config -g repo.packagist composer https://packagist.org - 再执行：
composer self-update - 升级完成立刻换回镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 跳过第一步，
self-update永远只会告诉你 “Up to date”
composer install 报 PHP 版本不满足，但 php -v 显示的是高版本
这和镜像无关，是 Composer 实际调用的 PHP 解释器和你终端里 php -v 不一致。镜像只管下载包，不参与版本校验逻辑。
- 运行
composer diagnose，看 “PHP binary” 行输出的路径是否和which php一致 - 如果不一致，说明 Composer 没走你期望的 PHP —— 优先修复 PATH 或显式指定路径
- 临时验证：
/opt/homebrew/bin/php@8.2 /usr/local/bin/composer install（macOS Homebrew） - 别信 alias 或 wrapper 脚本，它们在 CI、Git hooks 等非交互场景下大概率失效
config.platform.php 和镜像共存时的隐性冲突
config.platform.php 是声明式配置，只影响依赖解析阶段；镜像源则完全不读取这个配置。两者叠加时，容易让你误以为“已适配目标环境”，实则只是锁文件记错了。
立即学习“PHP免费学习笔记（深入）”；
- 设了
"platform": {"php": "8.2.0"}后，必须跟composer update --lock，否则composer.lock还是按旧平台生成的 - 镜像源不会帮你校验 platform 是否合理，也不会拒绝不匹配的包 —— 它只忠实地返回 Packagist 给它的数据
- CI 中若用镜像 + platform，务必确认构建镜像里真装了对应 PHP 版本，否则只是伪造了解析结果
- 全局镜像配置（
composer config --global）在多 PHP 版本共存时极易被忽略，它不感知当前项目 require 的 PHP 约束
真正卡住你的从来不是镜像同步延迟，而是 composer.phar 被哪个 php 解释器加载、composer.lock 记录的是哪次解析结果、以及你有没有手动删掉旧 vendor/ 目录重装 —— 这三点漏掉任何一个，换再快的镜像也没用。
