不能共用。多PHP版本下镜像必须与PHP版本强绑定，否则composer install会用错解释器、拉错包、生成不兼容vendor目录；全局镜像只改下载地址而不控制PHP运行时，无法感知版本或校验php约束，项目级配置需写入composer.json repositories首位并禁用packagist.org，且须删vendor和composer.lock后重装。
不能靠一个中文镜像配置管理多个 PHP 项目，必须为每个项目单独配镜像 + 显式绑定对应 PHP 版本，否则 composer install 会拉错包、生成不兼容的 vendor/、甚至静默降级到不支持 enum 或 match 的旧版依赖。
为什么全局镜像在多项目下反而失效
全局镜像（composer config -g repo.packagist）只改下载地址，不控制实际运行的 PHP 解释器。你本地有 php7.4 和 php8.2 时：
-
composer install调用哪个php，取决于$PATH顺序或你是否显式写路径； - 若误用
php7.4执行本该适配php8.2的composer.json，哪怕镜像再快，也会装出一堆不支持新语法的旧包； - 全局配置无法感知当前项目的
"php": "^8.2"约束，也不会校验是否满足； - 只要项目里已有
repositories字段，它就直接屏蔽全局镜像——你以为配了，其实根本没生效。
项目级镜像必须写进 composer.json 且格式严格
这是唯一能和 PHP 版本强绑定的方式，因为它是随代码提交的，构建时自动生效，且优先级高于全局设置。但写法极其敏感：
- 镜像对象必须放在
repositories数组首位； -
{"packagist.org": false}必须是独立对象，不是字段值； - URL 必须带末尾
/，类型必须是"type":"composer"； - 错误写法包括：
"repositories": {"packagist": {}}（对象而非数组）、漏掉{"packagist.org": false}、URL 少斜杠、键名写成repos.packagist。
正确示例：
立即学习“PHP免费学习笔记（深入）”；
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
},
{"packagist.org": false}
]
}
改完镜像后必须删 vendor/ 和 composer.lock
composer update 不会重读镜像配置，只有 composer install 才会按新 repositories 拉包。所以：
- 修改
composer.json后，先运行rm -rf vendor composer.lock； - 再执行
composer install，确保从头开始解析依赖树； - CI/CD 中尤其要注意：缓存的
composer.lock可能来自另一个 PHP 版本环境，直接复用会导致错位； - 安全做法是每次构建前加
composer clear-cache，并用--no-cache强制刷新元数据。
如何验证 Composer 真的用了目标 PHP 版本
镜像只是下载快慢问题，PHP 版本才是兼容性生死线。验证是否“人岗匹配”：
- 不要依赖
php -v或which php，要查composer文件头：head -n1 $(which composer)，看 shebang 是不是指向你要的版本； - 显式指定路径运行：
/opt/homebrew/bin/php83 /usr/local/bin/composer install； - 检查输出中是否有
Resolving dependencies (this may take minutes)—— 如果卡住，大概率是 Composer 在用错 PHP 版本查约束，导致平台不满足； -
config.platform.php只影响依赖解析逻辑，完全不改变实际执行的 PHP，别指望它绕过扩展缺失或语法报错。
最易被忽略的一点：多个项目共用同一份 composer.lock 缓存时，镜像地址和 PHP 版本约束可能早已错位，而错误不会立刻暴露——直到某次 composer install 生成了混用 php8.1 和 php8.3 包的 vendor/，上线后才爆 Fatal error: Uncaught Error: Undefined constant 'true' 这类诡异问题。
