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 ——但务必确保你清楚哪些包的功能在当前真实环境下不可用，否则运行时报错会更难定位。

# php  # js  # json  # composer  # 字节  # gmp  # 区别  # 为什么  # require  # 跳过  # 会报  # 的是  # 是因为  # 什么时候  # 你在  # 已被  # 这类  # 应在  # 报错