Composer本身不管理PHP版本，仅依赖shell中php命令指向的解释器；确认方式为执行php -v、which php和php -r "echo PHP_BINARY;"，最可靠切换方法是显式指定PHP路径运行（如/usr/bin/php8.2 composer.phar install），切换后必须删除vendor和composer.lock并重装。
Composer 本身不管理 PHP 版本，它只是个 PHP 脚本，运行时完全依赖你 shell 中 php 命令指向的解释器。所谓“多版本切换”，本质是控制哪版 php 在跑 composer，不是改配置、不是靠 platform、更不是重装 Composer。
怎么确认 composer 实际用的是哪个 PHP？
很多人跳过这步就改配置，结果所有操作都白费。必须在执行 composer install 前验证：
- 运行
php -v，看输出是否是你预期的版本（比如PHP 8.2.15） - 运行
which php，确认路径是否匹配（比如/usr/bin/php8.2，而不是模糊的/usr/bin/php） - 运行
php -r "echo PHP_BINARY;"，这个才是 Composer 内部真实调用的二进制路径 - 如果
which composer返回的是 shell 脚本，再执行head -n1 $(which composer)，看 shebang 行是不是#!/usr/bin/env php—— 这个php就是关键
显式调用目标 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 路径后） - 宝塔用户：
/www/server/php/82/bin/php /usr/bin/composer install
别用 alias composer='php8.2 composer' —— 在 Git hooks、Makefile、非交互 shell 中大概率失效。
立即学习“PHP免费学习笔记（深入）”；
COMPOSER_PHP 环境变量比 alias 更可靠
COMPOSER_PHP 是 Composer 2.2+ 原生支持的方式，只作用于当前命令，不修改系统状态，也不和 config platform.php 冲突：
- 临时生效：
COMPOSER_PHP=/usr/bin/php8.1 composer install - 写入 shell 配置（如
~/.zshrc）：alias composer81='COMPOSER_PHP=/usr/bin/php8.1 composer' - 注意：如果你的
which composer返回的是 shell 脚本（开头是#!/usr/bin/env php），那COMPOSER_PHP无效 —— 得换成php8.1 /path/to/composer.phar形式
切换 PHP 版本后 vendor 必须重装
这不是“建议”，是硬性要求。因为 vendor/composer/autoload_static.php 等文件的生成逻辑与 PHP 版本强相关：
- 不同 PHP 版本下，
match、联合类型、属性语法等解析结果不同，autoload 文件结构也不同 - 扩展启用状态（如
ext-mbstring）是运行时检查，platform不管这个 - 必须删除
vendor和composer.lock，再用目标 PHP 执行composer install - CI/CD 中尤其要注意：不能复用旧
vendor目录，哪怕只是换了 minor 版本（如 8.2.10 → 8.2.15）
真正容易被忽略的是：PHP CLI 的配置（php.ini）可能和 Web SAPI 完全不同，php --ini 输出的 Loaded Configuration File 路径一定要单独确认，否则扩展看似存在，实则未启用。
