Composer本身不支持多PHP版本共存，所谓“多版本”实为显式指定不同PHP解释器执行install/update；必须用目标PHP路径调用composer.phar（如/usr/bin/php8.1 composer install），并删除vendor与composer.lock后重装，config.platform.php仅影响依赖解析，不改变运行时环境。
Composer 本身不支持、也不允许项目“同时使用多个 PHP 版本”。所谓“多版本 PHP 共存”，实际是指在不同场景下，让 Composer **用不同的 PHP 解释器执行 install/update**，而不是让一个 vendor 目录兼容多个 PHP 版本——这根本不可能。
composer install 报 “PHP version does not satisfy that requirement” 怎么办
这不是配置没写对，是你当前 shell 的 php 命令指向的版本和 composer.json 里写的 "php": "^8.1" 不匹配。比如 php -v 输出 7.4.33，但项目要求 PHP 8.1+，Composer 就会直接拒绝解析依赖。
- 先运行
php -v和which php，确认终端当前生效的是哪个版本、哪个路径 - 别信
composer config --global platform.php—— 它只影响包选择逻辑，不改变实际运行环境 - 临时解决就一条命令：
/usr/bin/php8.1 composer install（Linux/macOS）或"C:\php\php-8.2\php.exe" composer install（Windows） - 如果用了 Homebrew，常用写法是：
php@8.2 -d memory_limit=-1 /path/to/composer.phar install，注意-d参数必须紧接 PHP 路径后
config.platform.php 是什么，又不是什么
config.platform.php 是 Composer 唯一允许你“声明目标平台 PHP 版本”的配置项，但它只在 install/update 阶段起作用，对运行时零影响。
- 适用场景：你在 PHP 7.4 的机器上，但要为 PHP 8.2 的生产环境打包
vendor/（比如 CI 构建部署包） - 设置方式：
composer config platform.php "8.2.10"，会写入composer.json的config段 - 必须配合
composer update --lock重生成composer.lock，否则锁文件仍记录着旧版本包 - 严重误用：本地是 PHP 7.4，设
"platform.php": "8.2"后composer install成功了，但一跑就报ParseError: syntax error, unexpected token "match"—— 因为match在 7.4 里根本不存在
为什么删了 vendor 和 composer.lock 还是报错
因为冲突根源不在缓存，而在环境不一致或约束没对齐。删了再装，只是用当前 php -v 的版本重跑一遍解析逻辑。
立即学习“PHP免费学习笔记（深入）”；
- 如果
php -v还是 7.4，而composer.json里还写着"php": "^8.1"，报错照旧 - FPM 和 CLI 版本不一致时，最容易出“安装成功、运行失败”：autoload.php 生成时用了 PHP 8.3 的反射行为，但运行时是 PHP 8.1，某些类映射就对不上
- 每次切换 CLI PHP 版本后，必须
rm -rf vendor composer.lock，再用对应版本重新composer install - CI 脚本中务必前置
php -v打日志，确认生效的是哪个版本
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' - Windows 批处理里可设：
set COMPOSER_PHP=C:\php\8.2\php.exe && composer install - 别用
alias composer='php8.2 composer'—— 在 Git hooks、Makefile、非交互 shell 中大概率失效
真正容易被忽略的点是：PHP CLI 版本和 FPM 版本可能完全不同，而 Composer 只认 CLI 版本；vendor/autoload.php 本身不绑定 PHP 版本，但它加载的代码可能依赖特定语言特性——所以不是“能不能装”，而是“装完能不能跑”。
