Composer私有仓库连接超时解决方法-composer-PHP中文网

私有仓库连接超时与composer镜像配置无关，根源在git层认证、tls证书或dns代理问题；需手动验证ssh连通性、检查url格式、确认密钥权限、排查ca证书及内网dns/代理分流。

composer私有仓库连接超时解决方法

私有仓库连接超时，不是 Composer 配置错了，而是它根本没走镜像源——repo.packagist 只影响公共包，对 type: "vcs" 或 type: "package" 的私有源完全无效。必须单独处理 SSH、HTTPS、代理和 DNS。

卡在 Cloning into '/vendor/xxx' 是 Git 层问题，不是 HTTP 超时

报错含 Could not read from remote repository 或 ssh: connect to host github.com port 22: Connection timed out，说明 Composer 正在用 Git 克隆私有仓库，此时 http.timeout 和 process-timeout 全部不生效。

先手动验证 Git 连通性：ssh -T git@github.com（GitHub）或 ssh -T git@gitlab.example.com（自建 GitLab）；失败就别折腾 Composer，先修 SSH
检查 composer.json 中私有仓库的 url：必须是 git@host:owner/repo.git 格式；若用 HTTPS，得提前配好 git config --global credential.helper store，否则静默卡死
CI 环境（如 GitHub Actions / GitLab CI）中，~/.ssh/id_rsa 必须由 runner 用户拥有，且权限为 600；sudo -u www 下运行的进程读不到 root 的密钥
别依赖 git config --global user.name：它不影响认证，只影响 commit author

私有源走 HTTPS 却卡在 TLS 握手，大概率是 CA 证书过期

报错含 cURL error 60、SSL certificate problem 或日志停在 * TLS handshake，说明 PHP 的 OpenSSL 无法验证私有仓库域名的证书链，常见于内网自签名证书或镜像站证书更新后未同步系统 CA。

Discussion Composer

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

下载

查当前 CA 路径：php -i | grep -E "(openssl\.cafile|curl\.cainfo)"，输出类似 /etc/ssl/certs/ca-certificates.crt
若用自签名证书，把根证书追加进该文件：cat your-ca.crt | sudo tee -a /etc/ssl/certs/ca-certificates.crt，再运行 sudo update-ca-certificates
临时绕过验证（仅调试）：export GIT_SSL_NO_VERIFY=1，但生产环境禁用
Windows + WSL2 组合下，PHP CLI 常读取 Windows 的证书存储，可改用 php -d openssl.cafile=/path/to/cert.pem composer install

公司网络下连不上私有 GitLab，优先检查 DNS 和代理分流

能访问公网但连不上内网 GitLab，大概率是 DNS 解析失败或代理规则把内网域名误转发到外部代理。这类问题在启用全局代理或企业 PAC 脚本时高频出现。

手动测 DNS：dig gitlab.internal.company.com @8.8.8.8；若无响应，说明内网 DNS 未被正确查询，需在 /etc/resolv.conf 里把内网 DNS 放第一行
确认代理是否分流：运行 curl -v https://gitlab.internal.company.com，看 CONNECT 请求是否发往代理地址；若发了，就得在代理配置里加 no_proxy 规则，例如 export no_proxy="gitlab.internal.company.com,192.168.0.0/16"
Git 层级代理：设 git config --global http.https://gitlab.internal.company.com.proxy "" 显式禁用代理，避免 Git 自动继承系统变量
Windows 用户注意：PowerShell 的 $env:http_proxy 和 CMD 的 %http_proxy% 互不继承，CI 脚本要用一致的 shell 环境

私有仓库 URL 写错导致静默 fallback 到 packagist.org

Composer 不报错也不提示，但实际请求发给了 packagist.org，最后因权限不足或 404 失败。典型原因是 repositories 数组里 URL 拼写错误、协议缺失或缺少 type 字段。

检查 composer.json 的 repositories 是否符合格式：
```
{
  "type": "vcs",
  "url": "https://gitlab.internal.company.com/group/project.git"
}
```
缺少 "type": "vcs" 会导致 Composer 忽略该条目
URL 必须可直接访问：在浏览器或 curl -I 打开 https://gitlab.internal.company.com/group/project.git，确认返回 200；若返回 401/403，说明鉴权未配
别混用协议：同一仓库同时配置 git@ 和 https://，且未设 preferred-install，Composer 可能随机选一个失败路径
验证是否真在用私有源：加 -vvv 参数运行 composer install，搜日志里的 Reading package info from，确认 URL 是你写的内网地址，不是 packagist.org/p/...