答案:cURL error 7、failed to open stream或卡在* TLS handshake均表明HTTPS握手失败,属系统级TLS问题,需用curl -I验证镜像可达性,并检查OpenSSL扩展、CA证书、代理及缓存。

curl -I 测试镜像域名是否可 HTTPS 访问
Composer 报错含 cURL error 7、failed to open stream 或卡在 * TLS handshake,说明请求根本没完成 HTTPS 握手——这和 Composer 配置无关,是系统级 TLS 层失败。
直接验证目标镜像是否可达:curl -I https://mirrors.aliyun.com/composer/packages.json
若卡住、超时或返回 curl: (35) SSL connect error,问题出在 OpenSSL、CA 证书或网络中间设备。
- Alpine 镜像必须装 CA 证书:
apk add --no-cache ca-certificates - Docker 多阶段构建中,final 阶段若用非 root 用户(如
www-data),它默认不读/etc/ssl/certs,需显式复制:COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ - 企业内网常见中间人代理,临时绕过证书校验(仅调试):
composer config -g secure-http false+composer config -g cafile /dev/null
php -m 确认 openssl 扩展已启用
Composer 的 HTTPS 下载依赖 PHP 的 openssl 扩展。如果 php -m | grep openssl 无输出,curl 和 file_get_contents 对 HTTPS 的调用会静默失败,且 Composer 不报明确错误,只表现为“卡住”或“Connection refused”。
- Ubuntu/Debian:
sudo apt install php-openssl - CentOS/RHEL:
sudo yum install php-opcache(常连带 openssl)或检查extension=openssl是否在php.ini中启用 - 宝塔、AMH 等面板环境,需在 PHP 设置页手动勾选 openssl 扩展
composer diagnose 检查 repo 配置与 secure-http 状态
composer diagnose 输出中 “Repo packagist.org:” 行显示实际生效的 URL,“secure-http:” 行则告诉你是否强制走 HTTPS。如果这里显示 secure-http: false,而你配置的是 HTTPS 镜像,Composer 可能降级尝试 HTTP,但镜像站通常不开放 HTTP 端口,导致 404 或连接拒绝。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 强制开启安全协议:
composer config -g secure-http true - 确认镜像地址是 HTTPS 开头:
composer config -g repos.packagist(注意是repos,不是repo) - 若输出为空或为
false,说明全局配置未写入成功,检查~/.composer/config.json文件权限及内容格式
删掉 ~/.composer/cache/repo/https---* 目录再试
即使运行了 composer clear-cache,Composer 仍可能复用 ~/.composer/cache/repo/https---mirrors.aliyun.com/composer/ 下缓存的 provider 和 packages.json——这些文件若在证书失效期间下载过,就带了损坏的 TLS 上下文,后续所有 HTTPS 请求都可能继承失败状态。
- 手动清理:
rm -rf ~/.composer/cache/repo/https---* - 验证是否重拉元数据:
composer update --dry-run -v 2>&1 | grep "Downloading https",看到新请求日志才算真正刷新 - Composer ≥ 2.5 可跳过手动删目录,改用:
composer update --refresh
复杂点不在“清不清缓存”,而在“哪个进程、以什么用户身份、读哪份证书、连哪个 repo 路径”。一次 curl -I + 一次 composer diagnose + 一次 rm -rf ~/.composer/cache/repo/https---,基本覆盖 95% 的 HTTPS 协议层失败场景。










