解决Composer网络传输层安全协议报错的方案-composer-PHP中文网

直接结论：95%是secure-http拦截http镜像或php的curl/openssl缺失；需确认secure-http为true、镜像为https、curl支持ssl、证书有效且系统时间准确。

解决composer网络传输层安全协议报错的方案

直接结论：报 TransportException、cURL error 1、“HTTPS not supported” 或 “HTTP protocol is disabled”，95% 是 secure-http 拦截了 HTTP 镜像源，或 PHP 的 cURL/openssl 扩展缺失/未启用，不是网络不通，也不是 Composer 坏了。

确认 secure-http 是否被意外关闭

secure-http 默认为 true，一旦设成 false，Composer 会强制把所有 HTTPS 镜像降级为 HTTP，再被底层 cURL 拒绝——形成“配置关 TLS → 请求发 HTTP → 协议被禁 → 报 TransportException”的闭环。

运行 composer config -g secure-http，输出必须是 true；若为 false，立刻执行 composer config -g secure-http true
别信 composer.json 里的配置：全局配置 repo.packagist 和 secure-http 优先级远高于项目级，composer.json 里写 "secure-http": true 是无效的
企业内网临时调试才允许设 false，且必须搭配明确的 HTTP 镜像（如 http://packagist.laravel-china.org），阿里云等主流镜像已停用 HTTP，设错直接失败

验证镜像源 URL 是否合法且生效

镜像地址不合法，Composer 会静默 fallback 到官方源 https://packagist.org，而你本地又连不上它，最终表现为“Unknown transport error”或卡在 Loading composer repositories。

Discussion Composer

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

下载

必须用全局命令设置：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾 /）
键名只能是 repo.packagist（单数、全小写），写成 repos.packagist 或 repositories 都静默失败
执行后立刻验证：composer config -g repo.packagist 输出应为完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
手动测镜像是否返回 JSON：curl -I https://mirrors.aliyun.com/composer/packages.json，必须看到 HTTP/2 200 和 Content-Type: application/json；若返回 HTML（如人机验证页）或 302，换源

检查 PHP 的 cURL 和 openssl 是否真可用

Composer 跑在 PHP 上，但命令行 curl 和 PHP 绑定的 cURL 可能是两个版本。PHP 编译时没开 SSL 支持，或 php.ini 里没启用扩展，就会报 “protocol https not supported in libcurl”。

确认 openssl 扩展已加载：php -m | grep openssl，无输出就去 php.ini 解注 extension=openssl，并重启 CLI 环境
确认 cURL 支持 SSL：php -r "var_dump(curl_version()['features'] & CURL_VERSION_SSL);"，输出非 0 才正常
对比版本：which curl 和 php -r 'echo curl_version()["version"] . "\n";'，若差异大（如系统 curl 8.x，PHP 绑的是 7.2.x），说明 PHP 环境异常，优先换官方 PHP 包
Windows 用户注意：php.ini 中必须同时启用 extension=php_openssl.dll 和 extension=php_curl.dll，且路径正确

排查证书与系统时间问题

即使镜像和配置都对，certificate verify failed 或 unable to get local issuer certificate 也会触发 TransportException——这不是 Composer 错，是 OpenSSL 校验失败。

查证书路径：php -r "print_r(openssl_get_cert_locations());"，看 default_cert_file 指向哪；Linux 常见路径是 /etc/ssl/certs/ca-certificates.crt，macOS 是 /usr/local/etc/openssl/cert.pem
检查系统时间：date，误差超 ±5 分钟，证书即视为“未生效”或“已过期”，校验直接失败
Windows 下常见 PHP 未加载证书路径：在 php.ini 显式加 openssl.cafile="C:\php\cacert.pem"（需先下载 cacert.pem）
临时验证是否证书问题：curl -v https://mirrors.aliyun.com/composer/，若卡在 * TLS handshake 而非 * Connected to，基本可锁定证书链或中间人代理

最易被忽略的一点：CI/CD 环境中，你用 root 配的镜像，但实际执行 composer install 的是 www-data 或 runner 用户，composer config -g 配置只对当前用户生效，必须用 sudo -u www-data composer config -g ... 单独配。