答案:需同时配置openssl.cafile和curl.cainfo为同一有效cacert.pem绝对路径,并通过php -r "print_r(openssl_get_cert_locations());"确认ini_cafile生效,再用composer diagnose验证TLS连接是否可信。

查 PHP 的 openssl.cafile 和 curl.cainfo 配置
Composer 本身不直接管理证书路径,它依赖 PHP 底层的 OpenSSL 和 cURL 扩展进行 HTTPS 请求。真正起作用的是这两个 INI 配置项:
-
openssl.cafile:PHP stream(如file_get_contents)校验证书时使用的根证书文件路径 -
curl.cainfo:cURL 扩展(Composer 下载包主要用它)校验时使用的根证书文件路径
它们可以不同,但最好指向同一个有效证书文件。运行以下命令查看当前生效值:
php -r "print_r(openssl_get_cert_locations());"
输出中重点关注 ini_cafile 和 ini_capath 字段。如果 ini_cafile 为空或路径不存在,就极可能是证书问题根源。
用 composer diagnose 快速暴露证书链问题
composer diagnose 会主动尝试连接 https://packagist.org 并验证 TLS 连接是否可信。它不只是测通不通,还会报告证书链是否可验证:
- 若看到
HTTPS is available✅ 且无警告,说明当前环境证书配置大概率正常 - 若提示
SSL certificate problem: unable to get local issuer certificate或类似错误,说明 PHP 找不到或无法加载有效的 CA 包 - 注意:该命令不会告诉你用了哪个具体文件,但它能确认「是否失败」以及「失败是否由证书引起」
这是最贴近真实使用场景的验证方式——它复现了 composer install 时的网络行为,比单纯检查配置更可靠。
手动测试证书路径是否真被 Composer 使用
即使 openssl_get_cert_locations() 显示了路径,也不能保证 Composer 在下载时真的读取了它。最直接的验证方法是临时替换为一个空文件或故意损坏的证书,看是否立即报错:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 备份原证书文件(如
/etc/ssl/certs/ca-certificates.crt) - 执行:
echo "" > /tmp/empty-ca.pem - 临时覆盖配置:
php -d openssl.cafile=/tmp/empty-ca.pem -d curl.cainfo=/tmp/empty-ca.pem composer diagnose
如果立刻报 SSL 证书错误,说明 Composer 确实走的是这个路径;如果没反应,说明它可能被环境变量(如 SSL_CERT_FILE)或 CaBundle::getSystemCaRootBundlePath() 的逻辑绕过了。
确认 Composer 是否 fallback 到内置 Mozilla 证书
当系统证书不可用时,Composer(通过 composer/ca-bundle)会自动加载内置的 res/cacert.pem。你可以主动触发并验证它是否生效:
- 先清空所有证书相关配置和环境变量:
php -d openssl.cafile="" -d curl.cainfo="" -d extension=openssl composer diagnose - 若仍显示
HTTPS is available,基本可断定 fallback 成功 - 进一步确认:在代码中调用
\Composer\CaBundle\CaBundle::getSystemCaRootBundlePath(),它返回的路径如果是vendor/composer/ca-bundle/res/cacert.pem,就说明正在用内置包
这个 fallback 很关键——它意味着即使你没配任何证书,Composer 仍可能工作。但要注意:内置证书不会自动更新,长期依赖它有信任过期风险。
真正容易被忽略的是:composer diagnose 成功 ≠ 项目里所有 HTTPS 请求都安全。比如 Guzzle、cURL 封装库或自定义 stream context 可能绕过 Composer 的证书逻辑,各自读取自己的 cafile。验证必须落到具体调用栈上,不能只信顶层命令。










