composer --version首行输出才是真实PHP版本，如PHP 8.2.5 (cli)；查shebang（head -1 $(which composer)）可确认是否硬编码路径；临时指定需用绝对路径调用，如/usr/bin/php8.2 /usr/local/bin/composer install。
composer --version 首行输出才是真实 PHP 版本
别信 php -v，它只告诉你当前 shell 的默认 PHP；composer --version 第一行输出（如 PHP 8.2.5 (cli)）才是 Composer 实际加载的解释器版本。这是唯一可靠验证方式——因为 Composer 是个 PHP 脚本，谁启动它，它就归谁管。
另一个验证手段是查 shebang：head -1 $(which composer)。如果输出 #!/usr/bin/env php，说明它走 $PATH 查找；如果是 #!/usr/bin/php8.1，那就是硬编码路径，改 PATH 也没用。
常见错误现象：你刚用 brew link php@8.2 切换系统默认 PHP，但 composer --version 仍显示 8.1——说明全局 composer 命令本身被旧版 shebang 锁死了，没跟着 PATH 变。
/usr/bin/php8.2 /usr/local/bin/composer install 是最稳的临时指定方式
绕过所有 alias、PATH、shebang 干扰，直接用目标 PHP 解释器启动整个 Composer 进程。这在 CI/CD 和本地多版本调试中必须用，且命令里两个路径都得是绝对路径。
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：
/usr/bin/php8.2 /usr/local/bin/composer install - macOS Homebrew 用户注意：
/opt/homebrew/bin/php@8.2 ./composer.phar update（@符号不能漏） - Windows：
"C:\php\php-8.2\php.exe" composer.phar install（路径含空格必须加英文双引号） - 如果用
composer.phar，先确保可执行：chmod +x composer.phar
这个方式不改任何配置，也不影响其他命令，执行完就结束。CI 脚本里务必前置 php -v 和 composer --version 打日志，否则你根本不知道底层在用几。
COMPOSER_PHP 环境变量只影响 Composer 自身逻辑
COMPOSER_PHP 是 Composer 内部识别的唯一运行时覆盖变量，优先级高于 $PATH 和 shebang，但它只控制 Composer 的 autoload 生成、脚本执行等内部行为，不影响 vendor 里 PHP 代码的运行时环境。
必须在命令前即时设置，不能分两行写：
- ✅ 正确：
COMPOSER_PHP=/usr/bin/php8.2 composer install - ❌ 错误：
export COMPOSER_PHP=/usr/bin/php8.2然后单独跑composer install（某些 shell 下会丢失继承）
它和 config.platform.php 完全不同：config.platform.php 只骗过依赖解析阶段（比如让 composer update 选 PHP 8.1 兼容包），对 install 阶段无效，更不改变实际运行环境。
镜像源配错会导致 vendor-dir 等配置“看起来失效”
镜像源和 config.vendor-dir 各司其职：前者控制下载地址，后者控制解压路径。但如果你的镜像配置静默失败（比如 repo.packagist 键名多写了个 s、URL 缺末尾 /、或漏了 "type": "composer"），Composer 就会回退到 packagist.org，而国内网络常卡在 Downloading 或报 Could not find package——这时你根本等不到 vendor-dir 生效的那一刻。
验证是否真走镜像：
- 加详细日志：
composer install -vvv | grep "GET https://"，看请求地址是不是你的镜像 URL - 查诊断：
composer diagnose，看Repo packagist.org:后面是不是你设的镜像地址 - Windows 用户执行
composer config -g后必须重启终端，否则仍读缓存
真正容易被忽略的是：只要项目 composer.json 里写了 "repositories": []（哪怕空数组），全局镜像就彻底失效——你得把镜像显式写进这个数组里，且顺序不能错。
