用 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。
