Composer怎么检查系统要求 Composer怎么验证PHP扩展缺失【必备】

composer diagnose 检查php版本、openssl/zip/phar等关键扩展是否加载且可用、https网络连通性及tls配置；它不验证扩展功能完整性，故install时可能因底层依赖问题报错。

composer diagnose 会检查哪些系统要求

composer diagnose 是最直接的验证入口，但它不只看 PHP 版本，还会主动探测关键扩展是否加载、openssl 是否可用、zip 扩展能否解压、phar 是否支持写入等。它甚至会尝试访问 https://repo.packagist.org（默认源）来确认网络和 TLS 配置是否正常。

常见错误现象包括：

• PHP Warning: Module 'openssl' is already loaded —— 不是缺失，而是重复加载导致冲突
• The openssl extension is missing, which will reduce security —— 缺失 openssl，composer install 可能卡在包签名验证
• The zip extension is missing, which will reduce performance —— 没有 zip，Composer 会退回到慢速的纯 PHP 解压逻辑

php -m 和 composer diagnose 结果不一致怎么办

根本原因是：CLI 和 Web SAPI 的 PHP 配置文件（php.ini）往往不同。你运行 php -m 看到的是 CLI 模式下的扩展列表，而 Composer 运行时用的就是这个环境；但如果你在浏览器里跑 phpinfo()，看到的可能是 apache 或 FPM 加载的另一套配置。

实操建议：

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

• 先确认 Composer 用的是哪个 PHP：which php 或 composer --version 输出里的 PHP 路径
• 查它实际加载的 php.ini：php --ini
• 检查该 php.ini 里是否有 extension=openssl、extension=zip 等行，且未被注释
• linux 下常见坑：debian/ubuntu 安装了 php-zip 包，但 CLI 模式没启用 —— 需运行 phpenmod zip

为什么 composer install 时才报扩展缺失，diagnose 却通过

composer diagnose 默认只做轻量检测，比如只检查扩展是否存在，不验证其功能是否完整。而 composer install 会真正调用 openssl_verify()、ZipArchive::open() 等函数，这时才发现扩展虽加载，但底层依赖（如 libssl 版本太旧）导致函数调用失败。

典型表现：

• composer diagnose 显示 openssl OK，但 install 报 Error:060800A3:digital envelope routines:EVP_DigestInit_ex:disabled for fips
• zip 扩展存在，但 ZipArchive::open() 返回 false —— 常见于容器中缺少 libzip 库或权限问题
• 某些扩展（如 mbstring）虽已加载，但 mbstring.func_overload 被设为 7，会导致 Composer 内部字符串处理异常

CI 环境下快速验证 PHP 扩展是否就绪

别依赖交互式命令，用一行脚本判断关键扩展是否可被 Composer 安全使用：

php -r "exit(extension_loaded('openssl') && extension_loaded('zip') && extension_loaded('curl') ? 0 : 1);"    && echo "✅ extensions OK"    || echo "❌ missing required extension"

注意点：

• curl 虽非 Composer 硬性依赖（可用 stream 回退），但缺它会导致下载极慢或超时，CI 中务必检查
• windows 上 php -m 输出含乱码？改用 php --modules 更可靠
• docker 构建时，docker-php-ext-enable 后必须重启 PHP CLI 配置缓存（如 docker-php-source delete + docker-php-ext-install 组合更稳）

最常被忽略的是：扩展存在 ≠ 函数可用。有些扩展（如 gd）只在特定编译选项下才提供全部 API，而 Composer 某些插件会悄悄调用它们。真要保险，得在 CI 里跑一次最小 composer install 测试。