Composer HTTPS 请求依赖 PHP 的 OpenSSL 扩展和正确配置的 CA 证书链;需启用 openssl 扩展、设置合法可读的 ssl.cafile、同时配置 http-proxy 和 https-proxy,禁用 secure-http 仅绕过协议检查而非解决证书验证问题。

Composer 本身不处理 HTTPS 协议栈,它依赖 PHP 的 cURL 或 stream 扩展 + OpenSSL 底层能力发起 HTTPS 请求。匹配是否成功,关键不在 Composer 配置本身,而在于 PHP 进程能否用系统或自定义 CA 信任链验证目标服务器证书——比如 Packagist、私有仓库、GitHub API。
PHP 的 openssl 扩展必须启用且可用
这是最底层前提。没有它,Composer 连 https:// 地址都发不出去,直接报 cURL error 1: Unsupported protocol 或更模糊的连接失败。
- 运行
php -m | grep openssl(Linux/macOS)或php -i | findstr "openssl"(Windows CMD),确认输出中有openssl - 若无输出,需编辑
php.ini,取消注释extension=openssl(Windows 下是extension=php_openssl.dll),然后重启 PHP CLI 或 web server - 注意:CLI 和 FPM 的
php.ini可能不同,composer命令走的是 CLI 版本,务必检查对的配置文件(用php --ini确认路径)
Composer 的 ssl.cafile 必须指向合法 PEM 链,且 PHP 进程可读
当访问公司内网 HTTPS 私有仓库时,常见错误 cURL error 60: SSL certificate problem 并非证书“不对”,而是 Composer 拿不到完整、格式正确、权限可达的 CA 链文件。
-
ssl.cafile值必须是单个 PEM 文件,内容为中间 CA + 根 CA(顺序:中间在前、根在后),不能含空行、BOM、注释或非 PEM 文本 - 别手动用记事本拼接;用
cat intermediate.crt root.crt > ca-bundle.pem更可靠 - 必须用全局配置:
composer config --global ssl.cafile /etc/ssl/certs/company-ca.pem;项目级设置对网络层认证无效 - 验证 PHP 是否真能读取:在命令行执行
php -r "echo file_get_contents('/etc/ssl/certs/company-ca.pem');",若报错 Permission denied,说明 www-data 或当前用户无权读该路径
HTTPS 代理必须同时配 http-proxy 和 https-proxy
只设 http-proxy,Composer 对 Packagist 等所有 HTTPS 仓库请求仍会直连,导致超时或被拦截——因为 HTTPS 流量需通过 CONNECT 隧道,而这由 https-proxy 控制。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 两个字段缺一不可,且都必须用
http://协议前缀,哪怕代理监听的是 TLS 端口(如http://127.0.0.1:3128) - 命令必须加
--global:composer config --global http-proxy http://proxy.internal:8080和composer config --global https-proxy http://proxy.internal:8080 - NTLM 代理无法原生支持,必须前置
cntlm或px转换为标准 Basic 认证代理,再让 Composer 连这个本地中转地址 - 验证配置是否加载:
composer config --global --list | grep -E "(http|https)-proxy",应看到两行有效 URL
secure-http false 是临时绕过,不是匹配方案
设 composer config --global secure-http false 会让 Composer 允许从 HTTP 源拉包,但它不解决 HTTPS 连接本身的证书验证问题——只是跳过校验。这在调试私有仓库未配好 HTTPS 时有用,但上线即风险。
- 它仅影响源协议选择逻辑(是否强制
https://),不影响底层 TLS 握手和证书链验证 - 一旦仓库地址写成
http://,即使开了secure-http false,也仍可能因服务端重定向到 HTTPS 而触发证书校验失败 - 真正要“匹配”,永远优先修证书链、代理隧道、PHP OpenSSL 环境,而不是关校验
最容易被忽略的是:Composer ≥2.5 加载 ssl.cafile 的方式变了——它先尝试用该文件初始化 OpenSSL 上下文,失败则静默 fallback 到系统默认 CA 路径。这意味着你配了但路径错、格式错、权限错,它不会报错,只会继续用系统 CA,然后继续报 60 错误。排查时得从 file_get_contents 和 openssl x509 -in 开始,而不是只盯 Composer 输出。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










