composer install 因自签名证书失败是因 curl 拒绝信任未经系统认可的证书链；解决方式包括临时禁用 ssl 校验、导入根证书到系统信任库，或为 composer 单独指定 ca 文件路径。

为什么 composer install 会因自签名证书失败

Composer 默认启用 SSL 校验，访问 https://packagist.org 或私有仓库时，若系统 CA 证书库不包含你用的自签名根证书（比如企业内部 GitLab、Nexus Repository 的 HTTPS 端点），就会报错：cURL error 60: SSL certificate problem: self signed certificate in certificate chain。这不是 Composer 故意设障，而是 cURL 底层拒绝信任未经系统认可的证书链。

临时跳过 SSL 校验（仅限开发/调试）

最直接的办法是让 Composer 忽略证书验证，但仅限本地开发环境或一次性调试，切勿提交到 CI 或生产配置中：

• 运行 composer install --no-secure-http（Composer 2.5+）或 composer install -n（旧版需配合 COMPOSER_NO_SSL=true）
• 更粗暴但有效：设置环境变量 export COMPOSER_DISABLE_TLS=1，再执行命令（等效于强制走 HTTP）
• 注意：这会让所有 HTTPS 请求降级为 HTTP，存在中间人攻击风险，且部分私有仓库可能已禁用 HTTP 接口

正确导入自签名证书到系统信任库

长期方案是把你的自签名根证书（通常是 ca.crt 文件）加入系统级 CA 信任链，让 cURL 和 OpenSSL 原生识别它：

CurlShip Directory Submission

向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。

下载

• Linux（Debian/Ubuntu）：sudo cp ca.crt /usr/local/share/ca-certificates/ && sudo update-ca-certificates
• macOS（使用 Homebrew OpenSSL）：cp ca.crt $(brew --prefix openssl)/etc/openssl/certs/ && sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ca.crt
• Windows：双击 .crt 文件 → “安装证书” → 选择“本地计算机” → 存储位置选“受信任的根证书颁发机构”
• 验证是否生效：curl -v https://your-private-repo.example.com 不再报 cert 错误，Composer 就能自动复用该信任链

为 Composer 单独指定 CA 路径（推荐用于 CI 或容器环境）

当无法修改系统证书库（如 CI runner、Docker 容器），可让 Composer 显式使用指定证书文件：

• 将 ca.crt 拷贝到项目目录，例如 ./certs/ca.crt
• 设置环境变量：export COMPOSER_CAFILE=./certs/ca.crt
• 或写入 composer.json 的 config 段：

  "config": {
    "cafile": "./certs/ca.crt"
  }

• 注意：cafile 必须指向 PEM 格式证书（不能是 PFX/P12），且路径相对于当前工作目录；若用相对路径，在 CI 中建议用绝对路径避免定位失败

真正麻烦的不是加证书，而是证书链不完整——比如只提供了服务端证书，没附带中间 CA。这时候即使导入了根证书，cURL 仍会校验失败。务必确认你拿到的是完整的 PEM 链（从服务器证书开始，追加所有中间证书，最后是根证书），顺序不能颠倒。