核心是确保Composer按唯一明确的PHP版本解析依赖，而非适配多版本；需统一CLI、FPM与platform配置，显式调用目标PHP二进制执行install，并每次切换版本后删除vendor和composer.lock重装。
生产环境里 Composer 管 PHP 版本兼容，核心不是“让 Composer 适配多个 PHP”，而是**确保它只按一个明确、稳定、与运行时一致的 PHP 版本解析和生成依赖**。一旦 CLI 版本、FPM 版本、platform 配置三者不统一，vendor/autoload.php 就可能在部署后直接报 ParseError 或 Class not found。
为什么生产环境不能靠 update-alternatives 或 brew unlink/php 切 PHP？
这类操作改的是全局 shell 的 php 命令指向，但生产环境往往有多个项目共存、CI 流水线并行执行、甚至不同服务用不同 PHP-FPM 池——临时切系统默认 PHP 会污染其他构建任务，导致：
-
composer install在 CI 中用了 PHP 8.1，但实际 Nginx + php83-fpm 运行时报syntax error, unexpected token "match" - 某个部署脚本意外触发了
php -v检查，返回版本与预期不符，后续步骤静默失败 - 宝塔面板或 cPanel 用户手动切换站点 PHP 版本后，未清理旧
vendor/，autoload_static.php 仍含 PHP 7.4 的反射逻辑，PHP 8.3 运行时跳过类注册
必须显式调用目标 PHP 二进制执行 composer install
这是最可靠、最易审计的做法。不要依赖 $PATH，直接硬编码路径（CI 中可参数化）：
- Linux/macOS：
/usr/bin/php8.3 composer install（确认该路径真实存在，用ls -l /usr/bin/php8.3验证） - Windows：
"C:\php\php83\php.exe" composer install（注意双引号包裹含空格路径） - 容器内（Docker）：在
Dockerfile中固定使用RUN /usr/local/bin/php8.3 /tmp/composer.phar install --no-dev，不依赖php命令别名
CI 脚本开头务必加一行：php -v && ls -l $(which php)，把输出打到日志里，出问题时一眼定位 CLI 版本是否被覆盖。
立即学习“PHP免费学习笔记（深入）”；
config.platform.php 只能在打包阶段用，且必须重写锁文件
这个配置是“编译期欺骗”，仅影响 install/update 时的依赖选择逻辑，对运行时零影响。它唯一合法场景是：
- 你在 PHP 7.4 的构建机上，为 PHP 8.3 的生产服务器提前生成 vendor 目录（比如离线部署包）
- 你已验证所有选中的包在 PHP 8.3 下真实可用（用
roave/you-are-using-it-wrong扫描过）
启用方式不是改完 composer.json 就完事：
- 先设：
composer config platform.php "8.3.0" - 再强制重写锁文件：
composer update --lock --ignore-platform-reqs（--ignore-platform-reqs是为了让 update 能跨版本执行） - 最后在目标环境用对应 PHP 二进制跑：
/usr/bin/php8.3 composer install
如果只是本地开发机上加了 "platform": {"php": "8.3"} 却没跑 update --lock，composer.lock 里记录的仍是 PHP 7.4 下解析出的包，上线后必然出错。
每次切换 PHP 版本后，必须删 vendor 和 composer.lock 重装
这不是保守，是必须。因为 Composer 生成的 autoload 文件（尤其是 vendor/composer/autoload_static.php）会嵌入当前 PHP 版本的语法特征和扩展行为：
- PHP 8.2 生成的静态映射会包含
readonly属性判断逻辑，PHP 8.1 解析失败 - opcache.enable_cli 开关状态不同，会影响类定义缓存的生成方式
- 某些扩展（如
igbinary）在不同 PHP 主版本下序列化格式不兼容，导致 autoload_classmap.php 读取异常
所以生产部署脚本中，安全写法是：
rm -rf vendor composer.lock /usr/bin/php8.3 composer install --no-dev --optimize-autoloader
别省这一步。看似多花几秒，换来的是 ParseError 彻底消失。
