Composer不管理PHP版本，仅依赖shell中php命令指向的解释器；确认方式为执行php -v和which php，显式调用目标PHP二进制（如/usr/bin/php8.2 composer.phar install）最可靠，切换版本后必须删除vendor和composer.lock并重装。
Composer 本身不管理 PHP 版本，它只是个 PHP 脚本，运行时完全依赖当前 shell 中 php 命令指向的解释器。所谓“切换版本”，本质是让 Composer 启动时用对的 php，而不是靠改配置、改软链或幻想 platform 能让旧版 PHP 运行新版语法。
怎么确认 Composer 正在用哪个 PHP 版本
很多人跳过这步就开干，结果所有操作都白费。必须在执行 composer install 前，立刻验证：
- 运行
php -v，看输出是不是你预期的版本（比如PHP 8.2.15） - 运行
which php，确认路径是否匹配（比如/usr/bin/php8.2，而非/usr/bin/php这种模糊软链） - 如果用了
composer config platform.php "8.2.0"，它只影响依赖解析，和上面两个命令的输出无关——别把platform当成运行时开关
显式调用目标 PHP 二进制是最稳方案
不依赖 PATH、不碰系统软链、不改全局 php，直接指定解释器路径。这是 CI/CD 和多项目共存下的事实标准：
- Linux/macOS：
/usr/bin/php8.2 composer.phar install或php8.2 /path/to/composer.phar update - Windows：
"C:\php\php-8.2.12\php.exe" composer.phar install（注意路径带引号） - Homebrew 用户：
/opt/homebrew/bin/php@8.2 -d memory_limit=-1 /usr/local/bin/composer.phar install（-d参数必须紧接在 PHP 路径后） - 别用
alias composer='php8.2 composer'—— 在 Git hooks、Makefile、非交互 shell 中大概率失效
COMPOSER_PHP 环境变量是官方推荐的轻量方案
Composer 2.2+ 原生支持该变量，比 alias 更可靠，且不影响子进程环境：
立即学习“PHP免费学习笔记（深入）”；
- 临时生效：
COMPOSER_PHP=/usr/bin/php8.1 composer install - 写入 shell 配置：
alias composer81='COMPOSER_PHP=/usr/bin/php8.1 composer' - 它只控制 Composer 自身启动时用哪个 PHP，不干扰
platform配置逻辑，也不改变php -v输出 - 注意：如果你的
which composer返回的是 shell 脚本（开头是#!/usr/bin/env php），那COMPOSER_PHP无效——得换成php8.1 /path/to/composer.phar形式
删 vendor 和 composer.lock 是切换版本后的必做动作
不是“建议”，是硬性要求。因为 autoload 文件（如 vendor/composer/autoload_static.php）的生成逻辑与 PHP 版本强相关：
- PHP 8.1 生成的类映射可能跳过 PHP 8.2 新增的属性提升语法检查
- PHP 7.4 下生成的
autoload_classmap.php不含联合类型反射信息，一到 8.2 运行就 ClassLoader 找不到类 -
config.platform.php只骗过安装期，骗不过运行时；哪怕composer install成功了，只要 runtime PHP 版本不对，ParseError: unexpected token "match"会立刻出现 - 所以每次换 PHP CLI 版本后，必须
rm -rf vendor composer.lock，再用新版本重装
最常被忽略的一点：Web 服务器（如 Nginx + PHP-FPM）用的 PHP 版本，和终端里 php -v 显示的 CLI 版本，完全是两套东西。Composer 只认后者。别看到 phpinfo() 是 8.3 就以为万事大吉——先确保 php -v 也是 8.3。
