Composer如何查看项目的PHP环境需求_Composer check-platform-reqs【手册】

用 composer check-platform-reqs 仅校验 composer.json 中显式声明的 php 版本和扩展约束，不检查未声明但代码依赖的扩展、运行时实际加载版本及 Web 与 CLI 环境差异，故“无报错却运行失败”常见。

直接看结论：用 composer check-platform-reqs 能快速验证当前 PHP 环境是否满足项目 composer.json 中声明的 platform 或依赖包的 PHP 版本、扩展等要求——但它不检查本地已安装但未在 composer.json 中显式声明的扩展，也不校验运行时实际加载的扩展版本（比如 mbstring 的 ICU 版本差异）。

为什么 check-platform-reqs 有时“没报错却跑不起来”

这个命令只校验 composer.json 里明确写的约束，比如：

"config": {   "platform": {     "php": "8.1.10",     "ext-gd": "8.1.10"   } }

但它不会主动探测你是否装了 ext-curl，除非某个 require 的包在 require 或 require-dev 中写了 "ext-curl": "*"。常见踩坑点：

• 项目依赖的包在 composer.json 里没声明 ext-xxx，但代码里硬调用了，check-platform-reqs 完全不报
• PHP CLI 和 Web Server（如 apache mod_php / FPM）用的是不同 php.ini，命令行能过，网页 500
• platform 配置被注释或拼写错误（比如写成 "platfrom"），命令会静默忽略

check-platform-reqs 和 install 的行为差异

composer install 默认也会做平台检查，但仅当启用了 platform-check（Composer 2.2+ 默认开启）。区别在于：

立即学习“PHP免费学习笔记（深入）”；

• check-platform-reqs 是独立诊断命令，不读取 vendor/，不写锁文件，纯静态检查
• install 会结合 composer.lock 中记录的依赖版本再校验，更贴近真实部署场景
• 如果 composer.lock 里锁定了一个 PHP 8.0 兼容的包版本，但你本地是 PHP 8.3，check-platform-reqs 可能不报（因它只看 composer.json 声明），而 install 可能因锁文件冲突失败

怎么让检查更靠谱一点

光靠 check-platform-reqs 不够，建议组合使用：

• 运行 php -m 和 php -v，人工比对 composer.json 的 require 和 config.platform
• 加 --no-dev 参数测试生产环境： composer check-platform-reqs --no-dev
• CI 场景下，在 composer install 前加一步 composer validate --strict，能捕获配置格式和字段错误
• Web 环境务必单独执行 phpinfo() 页面确认扩展实际加载状态，尤其 opcache、apcu 这类需手动启用的扩展

真正容易被忽略的是：这个命令只告诉你“声明的约束是否满足”，不是“代码能不能跑”。上线前别只信它输出的 OK。