Composer SSL/TLS错误主因是PHP未启用openssl扩展或CA证书路径配置错误，需依次验证扩展状态、配置cacert.pem路径、镜像源键名（repos.packagist）及URL末尾斜杠，并避免滥用--no-secure-http。
Composer 安全连接异常（SSL/TLS 错误）根本不是证书“过期”或“失效”，而是本地 PHP 环境无法验证远程 HTTPS 响应的证书链——它卡在握手阶段，连包都没开始下。
检查 openssl 扩展是否真启用
很多报错看似 SSL 问题，实则是 PHP 根本没加载 openssl。运行 php -m | grep openssl，如果无输出，说明扩展未激活。
- 用
php --ini找到正在使用的php.ini路径 - 打开该文件，确认
extension=openssl这行**没有被注释**（即前面不能有分号） - Windows 下还需检查
php_openssl.dll文件是否存在且路径正确（extension_dir配置值） - CLI 和 Web SAPI 可能用不同
php.ini，务必确认你测试的是 CLI 版本（composer命令走的就是 CLI）
配置正确的 CA 证书路径
PHP 的 cURL 和 OpenSSL 默认不带完整 CA 包，尤其 Windows ZIP 包和某些 macOS Homebrew 安装版本。即使扩展开着，也会因找不到根证书而失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 从 https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251 下载最新
cacert.pem - 保存到确定路径，例如
C:\php\extras\ssl\cacert.pem（Windows）或/usr/local/etc/php/cacert.pem（macOS） - 在
php.ini中添加两行（路径必须用双引号包裹，且是**绝对路径**）：curl.cainfo = "C:\php\extras\ssl\cacert.pem"<br>openssl.cafile = "C:\php\extras\ssl\cacert.pem"
- 改完后重启终端，再运行
php -r "print_r(openssl_get_cert_locations());"，确认default_cert_file显示的是你刚设的路径
镜像源配置是否真正生效
很多人配了镜像却还在日志里看到 packagist.org，说明配置被忽略——Composer ≥ 2.2 后，全局镜像键名已改为 repos.packagist（复数），写成 repo.packagist 会静默失败。
- 正确命令：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repos.packagist应返回 URL；再跑composer install -vvv，看日志中请求的域名是不是镜像地址 - 注意：项目级
composer.json中只要存在空"repositories": []，就会覆盖全局镜像，删掉或改成有效配置 - URL 必须带末尾斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出错误路径）
临时绕过验证仅用于定位，别留着
加 --no-secure-http 或设 secure-http false 能让命令跑通，但这是把 SSL 层整个关掉，不是修复。它只用来快速确认：如果关了就成功，那问题一定出在证书链或中间代理上。
- 临时测试：
composer config -g secure-http false，然后composer clear-cache再试 - 恢复命令：
composer config -g secure-http true - 企业网络若拦截 SNI 或强制 TLS 1.3 协商失败，这类绕过是唯一调试入口，但上线前必须撤回
真正难排查的点在于：错误可能同时由多个环节叠加导致——比如 openssl 没开 + CA 路径错 + 镜像键名写错。建议按顺序逐项验证，每改一项就 composer clear-cache 并用 composer diagnose 快速反馈，不要堆叠修改后再一起试。
