检查当前系统环境是否满足项目所需的平台依赖,该命令读取composer.json中的platform配置,验证PHP版本、扩展等是否符合要求,不安装或修改内容,仅做静态检查,适用于部署前环境验证,可快速发现版本或扩展缺失问题,比composer install更轻量,适合CI/CD集成。

composer check-platform-reqs 命令的作用是检查当前系统环境是否满足项目所需的平台依赖。
验证平台依赖是否符合要求
这个命令会读取 composer.json 文件中定义的 platform 配置项,比如 PHP 版本、扩展(ext-*)、库(lib-*, 如 lib-pcre)等,并检查当前运行环境中是否满足这些条件。
它不会实际安装或修改任何内容,只是做一次静态检查,告诉你当前环境是否“支持”项目运行。
- 例如项目要求 "php": "^8.1",但当前 PHP 是 8.0,命令会提示不满足
- 如果代码用了 ext-gd,但 GD 扩展未启用,也会被检测出来并报错
适用于部署前的环境检查
在将代码部署到新服务器或切换开发环境时,使用该命令可以提前发现环境差异问题,避免运行时报错。
相比 composer install 时才报错,这个命令更轻量,适合集成到 CI/CD 流程或部署脚本中。
- 可在部署前自动执行,确保目标机器满足所有底层依赖
- 帮助运维人员快速定位缺少的 PHP 扩展或版本不匹配问题
与 composer install 的区别
composer install 在安装包时也会检查平台需求,但主要目的是阻止安装,而 check-platform-reqs 专用于主动验证环境。
它运行更快,不需要联网或操作 vendor 目录,纯粹做一次环境体检。
基本上就这些。这个命令简单但实用,尤其适合团队协作和多环境部署场景。










