composer check-platform-reqs 用于验证当前环境是否满足 composer.json 中的平台依赖,如 PHP 版本、扩展(ext-pdo、ext-curl 等),常用于部署前检查、CI/CD 流程或 Docker 构建后验证,确保运行环境兼容,避免运行时错误。

composer check-platform-reqs 命令用于检查当前系统环境是否满足 composer.json 中定义的平台依赖要求。
这个命令不会安装或更新包,它只是验证当前 PHP 环境(包括 PHP 版本、扩展、系统库等)是否符合项目所需的平台条件。它常用于部署前检查或 CI/CD 流程中,确保运行环境具备必要的依赖。
检查的内容包括:
• PHP 版本(如 "php": "^8.1")• 必需的 PHP 扩展(如 ext-pdo、ext-curl)
• Composer 自身支持的特性(如对 platform-check 的支持)
• 项目依赖中声明的平台需求(通过 provide 或 replace 字段模拟的情况)
例如,如果你的项目 require 了 ext-gd,但当前 PHP 没有启用 GD 扩展,运行该命令会提示缺失。
典型使用场景:
• 部署到新服务器前确认环境兼容性• Docker 构建完成后做最终验证
• 共享主机迁移时排查问题
• CI 脚本中作为质量门禁步骤
输出结果会列出所有未满足的平台需求,帮助你提前发现问题,避免在运行时出现致命错误。
基本上就这些,不复杂但容易忽略。










