Composer install 报 platform requirements 错误是因为当前 PHP 版本不满足 composer.json 中声明的 php 版本要求（如要求 ^8.1 但实际为 7.4.33），默认严格校验平台约束导致解析失败。
为什么 composer install 会报 platform requirements 错误？
当你在低版本 PHP 环境（比如 PHP 7.4）上运行依赖声明了 "php": "^8.1" 的项目时，composer install 会直接失败，并提示类似：
Your requirements could not be resolved to an installable set of packages.
Problem 1
- Root composer.json requires php ^8.1 but your php version (7.4.33) does not satisfy that requirement.这是因为 Composer 默认严格校验当前平台（PHP 版本、扩展等）是否满足 composer.json 中的 platform 或包的 require 声明。
什么时候该用 --ignore-platform-reqs？
它只应在你**明确知道后果且有控制权**时使用，典型场景包括：
- CI/CD 流水线中用旧版 PHP 构建，但最终部署环境是新版（如构建产物是静态文件或预编译字节码）
- 本地开发机 PHP 版本暂时无法升级，但你只调用兼容的子集功能（例如不执行依赖高版本语法的代码路径）
- 临时绕过某个扩展缺失（如
ext-gmp）导致的阻断，而你确认该扩展实际未被启用
--ignore-platform-reqs 会跳过所有平台约束——包括 php、ext-*、lib-*，不区分轻重。
--ignore-platform-reqs 和 --ignore-platform-req 的区别
后者是前者的缩写形式，二者完全等价。但容易混淆的是：--ignore-platform-req（少一个 s）在 Composer 2.2+ 之后已被废弃，运行会报错：
Unknown option: --ignore-platform-req必须写全
--ignore-platform-reqs。另外，它不能单独忽略某一项（比如只跳过 PHP 版本但保留扩展检查），如需精细控制，得改用 --ignore-platform-req=php 或 --ignore-platform-req=ext-zip 这类带参数的写法。
更安全的替代方案：用 config.platform 模拟目标环境
相比全局跳过，推荐优先在项目根目录的 composer.json 中声明虚拟平台版本：
{
"config": {
"platform": {
"php": "8.1.10",
"ext-gd": "8.1.10"
}
}
}这样 Composer 会按你指定的“假环境”解析依赖，既绕过本地版本限制，又保留依赖解析逻辑的完整性。它不会影响运行时行为，只作用于安装阶段。如果项目已上线、无法改 composer.json，再考虑 --ignore-platform-reqs ——但务必确保你清楚哪些包的功能在当前真实环境下不可用，否则运行时报错会更难定位。 
