check-platform-reqs 命令用于检查当前环境是否满足 composer.json 中声明的平台依赖。1. 验证 PHP 版本、扩展(如 ext-curl、ext-pdo)及函数支持是否就绪;2. 在部署或切换环境前发现缺失项,避免安装失败;3. 辅助调试 composer install 报错,清晰列出不满足的需求;4. 适用于 CI/CD 流程、共享主机或多 PHP 版本场景,确认实际运行环境符合预期。

Composer 的 check-platform-reqs 命令主要用于检查当前系统环境是否满足项目所声明的平台依赖要求。它不安装或更新包,而是快速验证 PHP 版本、扩展、函数支持等是否符合 composer.json 中定义的约束。
检测本地环境兼容性
在部署项目或切换开发环境时,你可能会遇到“这个包需要 ext-curl”之类的错误。check-platform-reqs 能提前告诉你缺少什么:
- 检查 PHP 版本是否符合要求
- 确认必需的 PHP 扩展(如 ext-mbstring、ext-pdo)是否已安装并启用
- 验证 Composer 自身或第三方包声明的平台需求
辅助调试依赖问题
当你执行 composer install 失败,提示平台依赖不满足时,可以单独运行:
composer check-platform-reqs
它会列出所有未满足的平台需求,比安装过程中的报错更清晰、专注。这有助于快速定位是缺扩展还是版本不对。
适用于共享主机或多PHP版本环境
在共享主机或使用 phpbrew、phoenix 等工具管理多个 PHP 版本时,容易混淆当前 CLI 使用的 PHP 配置。check-platform-reqs 显示实际生效的 PHP 及其扩展状态,帮助确认是否运行在预期环境中。
基本上就这些 —— 它是一个轻量但实用的诊断工具,帮你确保“代码能跑”的基础条件已经具备。










