Composer报错“PHP version does not satisfy that requirement”是因为它严格校验当前shell中php命令的真实版本（php -v）与composer.json中require.php或config.platform.php声明的版本是否匹配；config.platform.php仅在install/update时影响依赖选择，不改变运行时能力；必须用目标PHP二进制直接执行composer.phar，并同步清理vendor和composer.lock以确保环境一致。
Composer 本身不管理 PHP 版本，它只读取当前 shell 中 php 命令指向的版本来校验 composer.json 中的 "php": "^8.1" 约束。所谓“管理多个版本”，本质是控制哪个 PHP 解释器在执行 composer install 时生效。
为什么 composer install 总报 “PHP version does not satisfy that requirement”
这不是 Composer 故意卡你，而是它老老实实拿 php -v 输出的版本去比对 composer.json 里的 php 字段。常见现象：
- Web 用的是 PHP 8.3（
phpinfo()显示正常），但终端里php -v是 8.1 → 报错 - 你刚用
update-alternatives切了系统默认 PHP，结果 CI 脚本里没生效 → 安装失败 - 本地
which php指向 Homebrew 的php@8.0，而项目要求^8.2→ 直接拦住
核心问题永远是：运行 composer 的那个 PHP 解释器，和项目要求的不一致。
怎么指定特定 PHP 版本运行 Composer
最稳、最透明、最不容易出错的方式：绕过 php 命令软链接，直接调用目标 PHP 二进制文件执行 composer.phar。
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：
/usr/bin/php8.3 /path/to/composer.phar install - macOS（Homebrew）：
php@8.3 -d memory_limit=-1 /path/to/composer.phar install - Windows：
"C:\php\php83\php.exe" composer.phar install（路径含空格必须加引号）
关键点：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
-d参数必须放在 PHP 路径之后、composer.phar之前，否则被忽略 - 别用全局
composer命令（比如 shell 脚本封装的），它内部仍调用php，不可控 - 每次切换前，先确认路径有效：
/usr/bin/php8.3 -v或where php83（Windows）
config.platform.php 到底能不能解决问题
它只能“假装”PHP版本，仅影响依赖解析阶段（install/update），完全不改变运行时行为。
- 适用场景：你在 PHP 7.4 机器上，但要为 PHP 8.2 生产环境打包 → 设
"platform": {"php": "8.2.0"}，再跑composer update --lock - 禁用场景：本地是 PHP 7.4，却设 platform 为 8.2 后直接跑 Laravel 11 →
match、readonly语法在 7.4 里根本不存在，一运行就ParseError - 设置后必须跟
composer update --lock，否则composer.lock还记着旧解析结果
它不解决扩展缺失问题：设了 "ext-mbstring": "*"，但真实 PHP 没启用 mbstring，运行时照样崩。
切换 PHP 版本后 vendor 为什么总出问题
因为 vendor/ 不是纯静态资源，它是有状态的：
-
vendor/composer/autoload_static.php会根据当前 PHP 版本生成不同结构，比如是否包含联合类型检查逻辑 - 类反射行为、扩展加载顺序、opcache 设置差异，都会影响自动加载器注册结果
- PHP 8.2 的
match表达式写进某个类里，PHP 8.1 解析时直接报ParseError，不是 autoload.php 报错，而是第一次 require 那个类时报错
所以每次换 PHP CLI 版本，必须：
- 删掉整个
vendor/和composer.lock - 用目标 PHP 二进制重新执行
composer.phar install - 验证是否真能加载：
/usr/bin/php8.3 -d display_errors=1 -f vendor/autoload.php（不报错才算过关）
最容易被忽略的一点：很多人删了 vendor 却忘了删 composer.lock，结果重装时 Composer 还按旧锁文件拉包，冲突照旧。
