Composer网络环境诊断的常用命令-composer-PHP中文网

composer diagnose报ok却install失败，因其仅用http请求packagist.org且不验证https、镜像配置及真实依赖链路；真实install需经dns解析→tls握手→https元数据请求，故必须用composer install -vvv或curl -v验证。

composer网络环境诊断的常用命令

composer diagnose 为什么经常“报 OK 却 install 失败”

因为 composer diagnose 默认只做轻量级探活：它用 HTTP（非 HTTPS）请求 http://packagist.org，且不走真实依赖下载链路。一旦 DNS 被劫持成 127.0.0.1 或返回空响应，就会显示 http connectivity to packagist: FAIL；但若 DNS 返回了某个“能通 HTTP”的假地址（比如内网代理页），它反而会显示 OK，而真实 install 时走的是 HTTPS + SNI + 包元数据请求，直接失败。

验证是否真连得上镜像源，别信 diagnose 的 OK：

运行 composer config -g repo.packagist，确认输出是你配的镜像域名（如 mirrors.tuna.tsinghua.edu.cn），不是 packagist.org
执行 composer require monolog/monolog -vvv，看日志第一行 Downloading https://... 的域名是否匹配镜像地址
如果仍走原始源，立刻检查项目级配置：composer config repo.packagist —— 它优先级高于全局，会完全屏蔽 -g 设置

composer install -v 才是真正的网络链路压力测试

composer install -v（或 --verbose）强制触发完整网络流程：DNS 解析 → TCP 连接 → TLS 握手 → HTTP 请求 → 响应解析。它不缓存、不跳过、不模拟，是“试装一次”的最小代价验证。

常见卡点和对应现象：

Failed to connect to repo.packagist.org port 443: Connection timed out → TCP 层不通，大概率防火墙拦截或 IPv6 fallback 拖延
SSL certificate problem: unable to get local issuer certificate → 本地 PHP 的 CA 证书包过旧，需更新 cacert.pem
卡在 Resolving dependencies 长达数分钟 → 默认先尝试 IPv6 地址超时（1–3 秒/包 × 百个包 = 几分钟），不是网络慢，是协议栈行为

临时绕过 IPv6：加环境变量 CURL_IPRESOLVE=4 composer install；长期解决请统一配置镜像 + 清缓存。

Discussion Composer

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

下载

curl 命令模拟 Composer 真实请求路径

Composer 实际请求的是镜像源的两个关键路径：/packages.json（顶层元数据）和 /p2/ 下的压缩包清单。用 curl 直接测，比看错误日志快十倍：

测连通性与耗时：curl -o /dev/null -s -w "%{http_code} %{time_total}s" --connect-timeout 5 https://mirrors.aliyun.com/composer/packages.json
000 表示 DNS 失败或连接超时（不是 HTTP 状态码）
200 但 time_total > 2.0，说明延迟过高，不适合作为主力镜像
403 或 404 很可能是镜像路径变更（阿里云已从 /composer/ 改为 /php/composer/）
必须加 --connect-timeout 5，否则可能卡在 IPv6 TCP 握手不返回

CA 证书过期导致的“连接失败”其实根本没连出去

很多报错看着像网络不通，其实是 PHP 根本没发出去请求——openssl.cafile 或 curl.cainfo 指向一个 2022 年前的证书包，无法验证 ISRG Root X1/X2 等现代 HTTPS 证书，TLS 握手直接终止。

三步确认并修复：

查 PHP 实际用的证书路径：php -r "print_r(openssl_get_cert_locations());"，重点关注 default_cert_file 和 ini_cafile
下载最新证书：curl -sS https://curl.se/ca/cacert.pem -o /usr/local/etc/php/cacert.pem（Linux/macOS）
在 php.ini 中**同时且严格一致地**设置：curl.cainfo="/usr/local/etc/php/cacert.pem" 和 openssl.cafile="/usr/local/etc/php/cacert.pem"

改完必须重启 CLI 终端（新开 shell）或 Web 服务（Apache/Nginx/PHP-FPM），仅重载配置无效。这点最容易被忽略。