如何配置Composer以处理PHP版本不兼容和平台约束？

本文共计1021个文字，预计阅读时间需要5分钟。

《Composer 无法自动适配你的 PHP 版本，它仅按照你告诉它的版本去选择包。配置错误时，不是警告，而是直接中断 install/update 操作。》

composer.json 里的 "php" 字段到底起什么作用

这是项目对运行环境的**硬性声明**，不是建议。比如 "php": "^8.1" 意味着 Composer 在解析依赖树时，只会考虑那些明确声明支持 PHP 8.1+ 的包版本（如 monolog/monolog v3.0+），哪怕你本地是 PHP 8.2，它也不会选一个只标了 "php": "^8.0" 的 v2.x 版本——即使语法上能跑。

• 该字段只在 composer install 或 composer update 阶段生效，不影响运行时
• 它不校验扩展是否加载，只看包元数据中的 require.php
• 如果写成 "php": ">=8.1.0 ，能避免意外升到不兼容的 8.3.x 小版本
• 别用 ~8.1：它等价于 >=8.1.0 ，会错过 8.2.x 的安全修复

config.platform.php 是“编译期欺骗”，不是运行时补丁

config.platform.php 的唯一作用，是在依赖解析阶段覆盖 PHP_VERSION 常量，让 Composer “以为”自己跑在某个版本上。它**完全不改变实际执行环境**。