因为composer install会用当前PHP解释器校验composer.json的php约束并检查扩展，若锁文件由高版本生成而低版本执行，则直接报错；必须清空vendor和composer.lock后用目标PHP版本重装，显式指定PHP路径（如/usr/bin/php8.3 composer install）最稳妥，platform.php仅骗过安装阶段， runtime仍会因语法或反射差异崩溃。
composer install 为什么在不同 PHP 大版本间会失败
因为 composer install 不是“读锁文件就完事”，它会用当前运行的 PHP 解释器重新校验 composer.json 中的 php 约束，并检查扩展是否可用（如 ext-json、ext-mbstring）。如果锁文件是用 PHP 8.2 生成的，而你用 PHP 7.4 执行 composer install，哪怕所有包都存在，也会直接报错：This package requires php ^8.2 but your PHP version (7.4.33) does not satisfy that requirement。
这不是 Composer “故意卡你”，而是它的依赖解析逻辑决定的：它必须确保生成的 vendor/autoload.php 和类加载结构，在当前 PHP 版本下能真正运行。PHP 7 和 8 的语法、反射行为、扩展接口都有差异，跳过校验等于埋 runtime 错误。
- 错误不是出现在下载阶段，而是在解析
composer.lock时就终止 -
--ignore-platform-reqs可绕过，但不推荐用于部署环境——它会让 autoload 文件按错误版本生成，后续require时可能直接 fatal error - 即使
composer.json没写"php": "x.y"，某些包（如 Laravel、Symfony）的require里隐含了 PHP 版本约束，也会触发校验
PHP 8.1 → 8.3 切换时 vendor 目录必须清空
很多人以为只要 composer.lock 兼容，vendor 就能复用。事实相反：不同大版本 PHP 下，Composer 生成的 autoload 文件结构、类映射方式、甚至扩展检测逻辑都不同。比如 PHP 8.3 引入了新的 ReflectionEnum 行为，而 PHP 8.1 生成的 autoload_static.php 里可能调用了该类 —— 运行时报 Class not found。
所以切换大版本后，必须执行：
立即学习“PHP免费学习笔记（深入）”；
rm -rf vendor composer.lock- 确认当前 CLI PHP 是目标版本（
php -v+which php） - 再跑
composer install，让 Composer 用新版本重新生成整套 autoload 体系
跳过这步，composer install 可能成功，但第一个 require 'vendor/autoload.php' 就崩。
如何让 composer install 在指定 PHP 版本下稳定运行
别碰系统默认 php，也别信 alias 或 PATH 修改——CI、Git hooks、IDE 终端可能用不同 shell 环境，结果不一致。最稳的方式是显式拼接 PHP 路径和 Composer 可执行文件：
- Linux/macOS：
/usr/bin/php8.3 /usr/local/bin/composer install - macOS Homebrew：
/opt/homebrew/bin/php@8.3 /usr/local/bin/composer install（注意@符号不能漏） - Windows：
"C:\php\php-8.3\php.exe" composer.phar install（路径带空格必须加双引号） - 如果用的是
composer.phar，先确保有执行权限：chmod +x composer.phar
这个命令不依赖任何环境变量，CI 脚本里直接复制粘贴就能用。它绕过了 shebang、alias、软链所有干扰层。
platform.php 配置只骗过 install，骗不过 runtime
有人用 "platform": {"php": "8.3.0"} 来让低版本 PHP “假装”是 8.3，从而通过 composer install。这确实能让命令跑通，但后果严重：
-
vendor/autoload.php会按 PHP 8.3 的语法和反射规则生成（比如用enum类型声明） - 实际运行时 PHP 7.4 或 8.1 解析失败，报
SyntaxError或Unknown type - 某些包的条件加载逻辑（如基于
PHP_VERSION_ID的分支）也会走错路径
所以 platform.php 只适合临时调试或 CI 预检，绝不能用于生产环境部署。真要跨版本兼容，得靠代码层面降级（如避免 match 表达式、不用 enum），而不是靠配置“掩耳盗铃”。
