composer如何使用check-platform-reqs_composer运行环境依赖自测【指南】

composer check-platform-reqs 是 Composer 2.2.0+ 引入的命令，用于校验当前 php 环境是否满足 composer.json 中 config.platform 声明的 PHP 版本及扩展要求，不检查实际依赖包兼容性、require-dev 配置或间接扩展依赖。

Composer 本身没有 check-platform-reqs_composer 这个命令 —— 它是拼写错误或混淆产物，正确命令是 composer check-platform-reqs。

为什么运行 composer check-platform-reqs 会报错“command not found”

这个命令从 Composer 2.2.0 开始引入，如果你用的是旧版 Composer（比如 1.x 或 2.0/2.1），就会提示找不到该命令。

• 运行 composer --version 确认版本，低于 2.2.0 就必须升级
• 升级方式：执行 composer self-update（全局安装）或 php composer.phar self-update（phar 方式）
• 某些系统（如 ubuntu 的 apt 安装源）自带的 composer 版本极老，建议卸载后用官方安装脚本重装：

  php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php composer-setup.php sudo mv composer.phar /usr/local/bin/composer

composer check-platform-reqs 检查什么、不检查什么

它只校验当前 PHP 运行环境是否满足 composer.json 中声明的 platform 配置（即 config.platform 下的 PHP 和扩展要求），不检查项目实际 require 的包是否兼容。

• 例如你写了 "config": {"platform": {"php": "8.1.0", "ext-gd": "8.1.0"}}，它就检查本地 PHP 是否为 8.1.0、是否加载了 gd 扩展
• 但不会检查 monolog/monolog 要求的 php: ^7.2 是否与你当前 PHP 冲突 —— 那是 composer install 或 composer update 做的事
• 如果 composer.json 里根本没配 config.platform，该命令默认只检查 PHP 版本（不检查扩展）

如何让 check-platform-reqs 检查扩展（如 ext-mbstring、ext-curl）

必须显式在 composer.json 的 config.platform 中声明，否则它默认忽略所有扩展。

• 在 composer.json 中添加或修改：

  "config": {     "platform": {         "php": "8.2.0",         "ext-mbstring": "*",         "ext-curl": "*",         "ext-openssl": "*"     } }

• 注意："*" 表示“只要已加载即可”，不校验版本；若写 "8.2.0" 则会严格比对 phpversion('mbstring') 返回值
• 扩展名必须和 php -m 输出的名称完全一致（如不是 mbstring 而是 mbstring.so）
• windows 下扩展名可能带 php_ 前缀（如 php_mbstring.dll），但 check-platform-reqs 只认 mbstring

CI/CD 中自测运行环境时的典型误用

很多人把它当“项目依赖兼容性总检”，结果在 CI 里通过了，上线却报 class not found —— 因为漏掉了关键点。

• 它不检查 require-dev 里的平台要求，除非你加 --ignore-platform-reqs 以外的参数（但它本身不支持 dev-only 模式）
• 它不感知 platform-check 插件或第三方钩子，纯看 composer.json 静态配置
• 最常被忽略的是：docker 或 CI 环境中 PHP 是最小化安装，ext-zip、ext-pdo_sqlite 等看似“可选”的扩展，其实被某些包（如 symfony/Filesystem）间接依赖，而 check-platform-reqs 不会主动发现这种链式依赖