报错时Composer正用实际调用的PHP版本校验约束，须显式指定目标PHP路径执行（如/usr/bin/php8.2 composer install），并确认composer diagnose、PHP_BINARY与shebang中php路径三者一致；config.platform.php仅用于CI等特定场景，不可替代真实版本约束。
报错“requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement”时，不是 Composer 在挑刺，而是它正用你当前 shell 里 php 命令的真实版本做校验——不匹配就拦，没商量。关键不在“改环境”，而在“让 Composer 明确绑定目标 PHP 解释器”。
确认 Composer 实际调用的 PHP 版本
别信 php -v，也别信终端右下角显示的版本。Composer 启动时锁定的 PHP 二进制可能和你敲命令的完全不是同一个。
- 运行
composer diagnose，看 “PHP binary” 和 “PHP version” 行——这才是它真正加载的版本 - 运行
which composer，再执行head -n1 $(which composer)查 shebang（如#!/usr/bin/env php），这个php才是实际入口 - 运行
php -r "echo PHP_BINARY;"，输出路径必须和你期望的目标一致；中文用户尤其注意宝塔、phpstudy 等工具自带的 wrapper 脚本常硬编码旧路径
显式指定 PHP 路径执行 composer 命令
这是最稳、可复现、绕过所有 PATH/alias/wrapper 干扰的做法。路径必须是绝对路径，不能用 ~/ 或相对路径。
- Linux/macOS：
/usr/bin/php8.2 /path/to/composer.phar install - macOS Homebrew：
/opt/homebrew/bin/php@8.2 -d memory_limit=-1 /usr/local/bin/composer.phar install（-d参数必须紧接 PHP 路径后） - Windows：
"C:\php\php-8.2.12\php.exe" composer.phar install（路径含空格必须加引号） - 宝塔用户：
/www/server/php/82/bin/php /usr/bin/composer install
别乱用 config.platform.php 当解药
config.platform.php 是“编译期欺骗”，只影响 composer update 阶段的依赖解析逻辑，不改变任何运行时行为。
立即学习“PHP免费学习笔记（深入）”；
- 本地是 PHP 7.4 却设
"platform": {"php": "8.2.0"}→composer install可能成功，但一加载vendor/autoload_static.php就ParseError: unexpected token "match" - 适用场景极窄：仅限 CI 打包、或 PHP 7.4 开发机上为 PHP 8.2 生产环境提前生成 vendor 目录
- 设了之后必须立刻执行
composer update --lock，否则composer.lock仍记录旧平台选包结果 - 绝不能提交到团队仓库——它不是开发配置，是构建上下文
清理缓存再重装，别跳步
切换 PHP 版本后直接跑 composer install，大概率 panic 或 silent fail，因为旧 vendor/ 里可能含 PHP 7.4 编译的扩展、或由旧版本生成的 autoload 文件。
- 先删掉
vendor/和composer.lock - 用目标 PHP 路径执行
composer install（不是php composer.phar install，除非你明确控制了php指向） - 若项目有
config.platform.php，确认它和你实际执行的 PHP 版本一致；不一致就删掉，别留着误导自己
最容易被忽略的是：Composer 的 panic（空白输出、segfault、直接退出）往往不是 PHP 版本低，而是它启动时绑定的解释器路径根本不存在、权限不对、或被 wrapper 脚本劫持。验证三者路径一致（composer diagnose、PHP_BINARY、shebang 中的 php）比反复重装更省时间。
