Composer install卡在TLS握手阶段主因是默认直连https://repo.packagist.org时国内网络对TLS 1.3、SNI、OCSP等支持不稳定,表现为Loading composer repositories卡顿或SSL operation failed;禁用TLS极不安全,应优先校准PHP的cafile、禁用OCSP验证、绑定hosts及升级OpenSSL。

为什么composer install卡在 TLS 握手阶段
不是 Composer 慢,是它默认直连 https://repo.packagist.org 时,国内网络对 TLS 1.3 协商、SNI 扩展、OCSP Stapling 等环节支持不稳定,常表现为卡在 Loading composer repositories 或日志里反复重试 file_get_contents(): SSL operation failed。这不是证书过期,而是握手超时或被中间设备截断。
disable-tls 是最危险的“加速”方式
执行 composer config -g disable-tls true 会让所有 HTTPS 请求降级为 HTTP,看似跳过 TLS 问题,实则暴露包完整性校验、中间人攻击风险——尤其当镜像源本身不提供 dist 包哈希签名时,你下载的 zip 可能已被篡改。
- 仅限离线调试用,上线前必须恢复:
composer config -g --unset disable-tls - 阿里云、腾讯云等主流镜像已强制 HTTPS,设了
disable-tls反而会直接报错(HTTP 301 重定向失败) - PHP 的
openssl.cafile配置错误才是更常见的 TLS 失败原因,优先查这个
真正安全又快的 TLS 连接方案
核心思路:不绕开 TLS,而是让 TLS 握手更快、更稳。
- 换镜像源后,确认 PHP 的 CA 证书路径正确:
php -r "print_r(openssl_get_cert_locations());",若default_cert_file指向不存在的路径,需用composer config -g cafile /etc/ssl/certs/ca-certificates.crt显式指定 - 禁用 OCSP 检查(非必需但有效):
composer config -g http.ssl.verifypeer false—— 注意这不是关 TLS,只是跳过证书吊销状态在线验证,握手延迟下降明显 - 避免 DNS + TLS 双重延迟:在
/etc/hosts中预填镜像域名 IP,例如223.6.6.6 mirrors.aliyun.com,让 TLS 直接连 IP,省掉 DNS 查询时间 - Composer ≥ 2.5 支持
http.ssl.cainfo配置项,可指向轻量级证书包(如 Mozilla CA Bundle),比系统默认证书库更精简、加载更快
别忽略 PHP 自身的 TLS 性能瓶颈
即使网络和配置都对,PHP 的 OpenSSL 扩展版本太旧(如 OpenSSL 1.0.2)、未启用硬件加速、或与 libcurl 版本不匹配,也会导致 TLS 解密慢几倍。
- 检查当前 OpenSSL 版本:
php -r "echo OPENSSL_VERSION_TEXT;",低于OpenSSL 1.1.1建议升级 - 禁用 Xdebug:
php -d xdebug.mode=off $(which composer) install,Xdebug 会拦截并重放 TLS 流量,极大拖慢握手 - 如果用了自建代理(如 Clash、Surge),确保代理规则没把
mirrors.aliyun.com错误转发到境外节点——这类“伪加速”反而增加 TLS 跳数
实际生效最快的是「镜像源 + hosts 绑定 + cafile 显式指定」三件套。TLS 不是黑盒,它卡在哪,就优化哪一层;盲目关验证,等于把门锁换成纸糊的。











