Composer中文镜像加速PHPMailer等基础库下载的实例-composer-PHP中文网

composer镜像未生效是因为配置命令错误（键名、type值、url末尾斜杠缺一不可）、项目级repositories字段覆盖全局配置、composer.lock硬编码github地址，必须删vendor和lock文件并执行clear-cache，再用-vvv验证请求域名。

composer中文镜像加速phpmailer等基础库下载的实例

配了镜像但 PHPMailer 还是从 github.com 下载 zip，说明镜像根本没起作用——不是网络慢，是 Composer 仍在直连 GitHub，而国内对 api.github.com 和 codeload.github.com 的 TLS 握手、DNS 解析、连接重置才是真卡点。

composer config -g repo.packagist 为什么总不生效

这条命令写错任意一处，Composer 就静默 fallback 到 packagist.org，且不报错：

repo.packagist 写成 repos.packagist（多一个 s）或 packagist（少 repo.），配置不写入
漏掉中间的 composer 类型参数：composer config -g repo.packagist https://mirrors.aliyun.com/composer/ ❌，必须带 composer ✅
URL 少末尾斜杠：https://mirrors.aliyun.com/composer ❌ → 拼出 /composerpackages.json 导致 404；正确是 https://mirrors.aliyun.com/composer/ ✅

验证是否真写进去了？运行 composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍显示 https://packagist.org，说明没生效。

为什么删了 lock 文件再 install 才有效

composer.lock 里硬编码了每个包的 dist.url，比如 "https://api.github.com/repos/PHPMailer/PHPMailer/zipball/v6.9.1"。只要 lock 文件存在，Composer 就照着这个地址下，完全无视你配的任何镜像源。

amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码，依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态（http‑server、http‑client 等）。

下载

composer install 不会改 lock 文件，只按它执行下载
composer update 会重解析依赖并更新 lock，但前提是元数据走镜像——如果旧 lock + 旧缓存还在，仍可能从 github.com 拉
真正见效的做法：删掉 vendor/ 和 composer.lock，再跑 composer install -vvv

加 -vvv 是唯一确认方式：日志里出现 Loading composer repositories from https://mirrors.aliyun.com/composer/，且后续 Downloading 行的域名是 mirrors.aliyun.com，才算真正走镜像。

PHPMailer 这类 GitHub 托管包仍卡住？得绕过 GitHub 域名

阿里云等镜像只代理元数据（packages.json），不托管 zip 包。所以即使元数据从镜像拉得飞快，PHPMailer 的 zip 仍默认走 codeload.github.com ——这才是国内最卡的一环。

临时方案：用 ghproxy.com 类反向代理，把 github.com 请求转到国内节点：composer config -g github-protocols https（强制 HTTPS，避免 git 协议触发 SSH 问题）
项目级精准控制：在 composer.json 里为 phpmailer/phpmailer 显式指定 dist："dist": {"url": "https://ghproxy.com/https://codeload.github.com/PHPMailer/PHPMailer/zip/v6.9.1"}
企业级方案：部署 satis 或 toran proxy，把 GitHub zip 缓存到内网，彻底避开外网