如何检测当前Composer镜像源有效性-composer-PHP中文网

最准命令是composer config -g repo.packagist，它直接输出全局生效镜像url（如https://mirrors.aliyun.com/composer/），为空或报错则走官方源；composer diagnose不验证镜像有效性，仅检测基础环境。

如何检测当前composer镜像源有效性

直接查配置项，别信 composer diagnose

composer diagnose 只检查 PHP 环境、cURL 和 openssl 是否可用，它**不验证镜像源是否生效或连得通**。即使显示 “OK”，实际请求仍可能走 https://packagist.org 或卡在元数据拉取阶段。真正起作用的是配置项 repo.packagist（Composer 2.2+ 推荐）或 repos.packagist.org（旧版兼容）。运行以下命令看当前全局生效地址：

composer config -g repo.packagist

输出应为完整 HTTPS URL，且末尾带斜杠（如 https://mirrors.aliyun.com/composer/）。若为空、输出 https://packagist.org 或报错 Key "repo.packagist" does not exist，说明没配或配错。

常见错误：

漏写 -g → 只改了当前项目，换目录就失效
键名拼错：写成 repositories.packagist、repo.packagist.org 或 repos.packagist → Composer 2.2+ 会静默忽略
路径含中文或空格的 Windows 用户目录 → %APPDATA%\Composer\config.json 可能写入失败，需手动检查文件是否存在且可读写

用 curl 模拟真实请求路径测 p2 接口

只测 packages.json 返回 200 不够——镜像站首页可能通，但 Composer 实际依赖的是 /p2/{vendor}/{package}.json 这类元数据接口。阿里云、USTC、华为云等镜像均要求该路径返回含 packages 字段的有效 JSON。

推荐命令（超时设为 3 秒，带 UA 和 Accept 头）：

curl -fsSL --max-time 3 \
  -H "User-Agent: Composer/2.9.6" \
  -H "Accept: application/json" \
  https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -e 'has("packages")' >/dev/null

返回 0 表示可用；非零表示失败（如空响应、404、SSL 错误或 JSON 解析失败）。

关键细节：

必须用 p2/ 路径，不是根路径或 packages.json
部分镜像（如腾讯云）证书更新后 HTTPS 会临时中断，但 HTTP 仍通 —— Composer 强制 HTTPS，HTTP 请求会被拒绝
华为云当前有效地址是 https://repo.huaweicloud.com/repository/php/，不是旧版 mirrors.huaweicloud.com

看 composer -vvv 日志确认真实请求地址

配置写了 ≠ 请求走了。缓存、项目级 repositories 覆盖、或旧 composer.lock 都可能导致日志里仍出现 repo.packagist.org。

执行：

Discussion Composer

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

下载

composer clear-cache && composer -vvv show -p | head -10

观察日志中类似这样的行：

Downloading https://mirrors.aliyun.com/composer/packages.json

这才是 Composer **真实发出的请求地址**。如果看到的是 packagist.org 或 repo.packagist.org，说明镜像没生效，或项目 composer.json 里写了 "repositories" 覆盖了全局配置。

注意：

必须先 clear-cache，否则旧缓存里的元数据仍指向境外地址
删掉 vendor/ 和 composer.lock 再试，可排除本地状态干扰
某些企业网络会静默劫持 HTTPS 请求，表面连通实则未走镜像 —— 此时 curl -v 查 Connected to 更可靠

多镜像 failover 要靠 composer.json 显式声明

Composer 原生不支持自动故障转移，所谓“主备切换”本质是按顺序尝试多个 type: "composer" 源，并禁用默认 packagist.org。

在 composer.json 中正确写法：

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://mirrors.aliyun.com/composer/"
    },
    {
      "type": "composer",
      "url": "https://mirrors.ustc.edu.cn/composer/"
    }
  ],
  "packagist.org": false
}

关键点：