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不会主动发现这种链式依赖
