Composer install报错提示SSL连接握手失败？协议版本升级方案-composer-PHP中文网

ssl握手失败是tls协议协商卡住，非证书过期问题，根本原因是php或openssl版本过旧（如openssl

composer install报错提示ssl连接握手失败？协议版本升级方案

SSL握手失败不是证书过期，是TLS协议协商卡住

报错里出现 SSL routines:ssl3_get_server_certificate 或 cURL error 35，基本可排除证书本身失效——这是 TLS 握手阶段就断了，根本没走到证书校验环节。常见于 PHP 7.2 以下环境或 OpenSSL 版本太老，无法与现代镜像源（如阿里云、腾讯云）启用的 TLS 1.2+ 协商成功。

确认当前 OpenSSL 和 PHP 支持的 TLS 最高版本

别猜，直接看实际能力：

运行 php -r "print_r(openssl_get_cipher_methods());"，若输出里没有 TLSv1.2 或 TLSv1.3，说明 OpenSSL 库太旧
运行 php -i | grep "OpenSSL Version"，OpenSSL
用 curl -v https://mirrors.aliyun.com/composer/packages.json 2>&1 | grep "TLS" 看系统 curl 是否能走 TLS 1.2——如果它能通而 PHP 不行，就是 PHP 自带的 OpenSSL 绑定问题

升级 OpenSSL 和 PHP 是唯一可靠方案

临时改配置绕不过底层协议限制：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

Windows 用户：不要用 php.net 的 ZIP 包（自带 OpenSSL 1.0.2u 且无法更新），改用 phpenv 或 XAMPP 8.2+，它们默认打包 OpenSSL 3.0+
Linux/macOS：用 brew install openssl@3（macOS）或 apt install openssl libssl-dev（Ubuntu 22.04+），再重新编译 PHP 或切换到官方 ondrej/php PPA 源
Docker 用户：别用 php:7.4-cli 这类老旧 tag，改用 php:8.2-cli 或更高，并确认 base image 已含 OpenSSL ≥ 1.1.1
切记：只改 curl.cainfo 或 openssl.cafile 对 TLS 协议不匹配无效，这类错误必须升级底层

实在无法升级时的降级兼容操作（仅限测试）

某些 CI 或遗留服务器不允许升级，可强制 PHP 使用 TLS 1.2（非 1.3），但需满足两个前提：

PHP ≥ 7.2 且 OpenSSL ≥ 1.0.2k（否则 stream_context_set_option 不识别 crypto_method）
在项目根目录加 composer.json 片段：
```
"config": {
  "secure-http": false,
  "disable-tls": true
}
```
，然后运行 composer install --no-plugins
注意：COMPOSER_DISABLE_TLS=1 环境变量只对 Composer 2.2+ 生效；低于此版本必须靠 config 字段或全局 composer config -g disable-tls true

协议层的问题，永远不能靠换镜像或调超时解决——它卡在 TCP 三次握手之后、HTTP 请求之前。要么升级，要么接受不安全降级，没有中间选项。