Composer的check-platform-reqs命令用于检查PHP版本、扩展(如ext-json、ext-pdo)、扩展版本限制、HHVM等平台依赖是否满足项目要求,通过读取composer.lock或composer.json分析环境兼容性,不安装仅验证,在部署前发现缺失如ext-redis等问题,避免运行时错误,建议集成到CI/CD流程中提升上线稳定性。

Composer 的 check-platform-reqs 命令用于验证当前系统环境是否满足项目 composer.json 中声明的平台依赖。它特别适用于在部署前确认生产服务器的 PHP 版本、扩展和其他系统级依赖是否符合项目要求,避免因环境不匹配导致运行时错误。
检查哪些依赖?
该命令会读取项目中的 composer.lock 文件(或根据 composer.json 分析),检查以下几类平台需求:
- PHP 版本:如 "php": "^8.1"
- PHP 扩展:如 ext-json、ext-pdo、ext-gd 等
- 扩展版本限制:如 ext-mbstring: "^1.3"
- Composer 平台包:如 hhvm、php-64bit 等特殊标识
它不会安装或更新任何包,只做检查。
如何使用?
在目标服务器(如生产环境)上,进入项目目录后运行:
composer check-platform-reqs执行后会列出所有平台依赖项及其状态。如果某项不满足,会标出“Missing”或版本不符,帮助你快速定位问题。
例如输出中出现:
ext-gd 8.1.2 required (for image processing) ext-redis - required but not present说明 redis 扩展未安装,需要补装。
为什么要在部署前使用?
很多 PHP 项目在开发时依赖特定扩展或高版本 PHP,但生产环境配置可能滞后。直接部署后才报错(如“Class Redis not found”)会延长故障时间。check-platform-reqs 能在部署前主动发现问题,提升上线稳定性。
建议将其加入部署流程,比如 CI/CD 脚本或运维检查清单中,确保环境一致性。
基本上就这些,简单但实用。










