遇到Composer install报错提示无可用安全协议的底层配置-composer-PHP中文网

“alert handshake failure”主因是tls协议版本或加密套件不匹配，而非证书错误；需依次排查tls版本兼容性、密码套件交集、sni与证书链完整性、系统级安全策略限制，并用浏览器security面板或openssl验证。

遇到composer install报错提示无可用安全协议的底层配置

这是 OpenSSL 证书链或协议支持缺失导致的 TLS 握手失败，不是 Composer 配置问题。错误通常表现为 SSL routines:SSL23_GET_SERVER_HELLO:tlsv1 alert protocol version 或 unable to get local issuer certificate，本质是 PHP 的 cURL 扩展无法完成 HTTPS 连接协商。

检查 PHP 实际加载的 openssl 和 cafile 路径

Composer 依赖 PHP 的 OpenSSL 扩展和可信 CA 证书文件。很多报错看似“无可用安全协议”，实则是证书路径没配对或版本太旧。

运行 php --ini 确认 CLI 模式下真实生效的 php.ini 路径（别信 Web 环境的 phpinfo）
运行 php -r "print_r(openssl_get_cert_locations());" 查看 default_cert_file 和 ini_cafile 值——这两个路径必须存在且可读
若输出为空、路径不存在，或 cat /path/to/cacert.pem 报错，说明证书文件缺失或损坏

强制更新并绑定 cacert.pem 到 php.ini

Windows 和部分 Linux 发行版（尤其自编译 PHP）常缺最新根证书。别用系统自带的 cert.pem，直接下载权威来源：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

从 https://curl.se/ca/cacert.pem 下载最新 cacert.pem
保存为绝对路径，例如 /usr/local/etc/php/cacert.pem（Linux/macOS）或 C:\php\extras\ssl\cacert.pem（Windows）
在 php.ini 中显式设置两处：
curl.cainfo = "/usr/local/etc/php/cacert.pem"
openssl.cafile = "/usr/local/etc/php/cacert.pem"
改完重启终端（CLI 不需要 reload Apache/Nginx）

禁用 keep-alive 避免 NAT 设备伪造 RST 干扰 TLS 握手

某些网络环境下（如企业内网、校园网、云主机 NAT 网关），cURL 复用连接时会被中间设备发 RST 中断，表现就是 TLS 握手卡住或报“protocol version”错误——其实不是协议不支持，而是 socket 已失效。

临时绕过：Linux/macOS 下执行 CURL_OPTIONS="--no-keepalive" composer install
Windows cmd 下：先 set CURL_OPTIONS=--no-keepalive，再运行 composer install
PowerShell 下：$env:CURL_OPTIONS="--no-keepalive"; composer install
这个操作让每次请求都新建 TCP 连接，跳过被污染的 keep-alive 连接池

确认 secure-http 和镜像源协议是否匹配

如果手动配置过非 HTTPS 镜像源（比如 http://packagist.phpcomposer.com），而 secure-http 为 true（默认），Composer 会直接拒绝连接，错误可能被误读为“无安全协议”。

检查当前全局镜像：composer config -g repo.packagist，输出必须是 https://mirrors.aliyun.com/composer/ 这类 HTTPS 地址
确保命令中带 composer 类型标识：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
禁用 secure-http 是高危操作（所有包传输裸奔），仅限调试：composer config -g secure-http false

最易被忽略的是：openssl_get_cert_locations() 返回的路径和 php.ini 里写的路径不一致，或者证书文件权限为 root 且当前用户不可读。别只改配置，要验证路径真实可访问。