Composer镜像加速：打造极速开发工作流-composer-PHP中文网

composer 2.2+ 配置 repo.packagist 总不生效，因必须严格满足三条件：键名单数 repo.packagist（非 repos）、第二参数显式为 composer、url 以 https:// 开头且末尾带 /，任一缺失均静默回退官方源。

composer镜像加速：打造极速开发工作流

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

不是镜像慢，是你根本没配对。Composer 2.2+ 会硬编码跳过 repositories 字段，只认 repo.packagist 这个键名——多一个 s（repos.packagist）就彻底失效，且不报错。

必须同时满足三个条件：

repo.packagist（注意是 repo，不是 repos）
第二个参数必须是 composer（类型声明，漏掉就 fallback 到官方源）
URL 必须以 https:// 开头、末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）

验证方式：运行 composer config -g repo.packagist，输出应为完整 JSON 对象或纯 URL 字符串。如果为空、null 或仍是 https://packagist.org，说明配置没写进去。

Windows 下需管理员权限运行命令；macOS/Linux 请检查 ~/.config/composer/ 是否可写。误配后先执行 composer config -g --unset repo.packagist 清理再重试。

composer install 卡在 Downloading，不是镜像问题而是 zip 包直连 GitHub

配了阿里云镜像但依然卡在 Downloading https://codeload.github.com/？因为镜像只代理元数据（packages.json），不托管 ZIP 包。Composer 仍按 composer.lock 里记录的 dist.url 去下载，而这个 URL 多数来自 GitHub。

解决办法不是换镜像，而是绕过 GitHub：

临时加 --repository=https://mirrors.cloud.tencent.com/composer/ 参数——但它对已锁进 composer.lock 的 dist URL 无效
删掉 composer.lock 和 vendor/，再跑 composer install，让新 lock 文件生成国内镜像的 dist 地址
个人开发推荐用 ghproxy.com 类反向代理：在 composer.json 中显式改 dist.url 指向 https://ghproxy.com/https://codeload.github.com/...
企业级方案部署 satis 或 toran proxy，把 GitHub zip 缓存到内网

别信 --repository 能“一劳永逸”——它只影响元数据获取环节，对 lock 文件里的旧路径毫无作用。

Docker 构建中 composer install 依旧慢，因为容器根本不读宿主机配置

你在本地配好了镜像源，Docker 构建却还是卡在 Downloading https://packagist.org/？因为容器是干净环境，~/.composer/config.json 不会自动透传进来。

Discussion Composer

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

下载

必须把镜像源“写进构建流程”：

在 Dockerfile 的 RUN composer install 前插入：RUN composer config --global repo.packagist composer https://mirrors.cloud.tencent.com/composer/
更稳妥的做法：COPY 一个预配置好的 composer.json（含 repositories 数组首项禁用 packagist.org）进镜像
直接用参数：RUN composer install --repository=https://mirrors.cloud.tencent.com/composer/ --no-dev --prefer-dist --optimize-autoloader

注意分层缓存：把 COPY composer.json composer.lock ./ 放在 RUN composer install 之前，否则任何代码改动都会让依赖安装层失效。

若项目用了私有 VCS 源（如 GitLab），镜像配置不会干扰它——但这类依赖仍走原始地址，不能指望换源解决。

CI/CD 部署慢，关键不是镜像而是参数和缓存路径

CI 流水线里 composer install 动辄 3–5 分钟？90% 是参数缺失或缓存路径不合理，而非网络问题。

必须加的参数组合：

--no-interaction：避免无终端时卡住
--prefer-dist：强制下 ZIP，跳过 git clone 和 SSH 认证开销
--no-dev：省掉 30%–60% 时间
--optimize-autoloader：生成 classmap，提升运行时性能且不影响部署速度

缓存路径也常被忽略：~/.composer/cache 若落在机械盘、WSL2 挂载目录或 NFS 上，I/O 会成瓶颈。查当前路径：composer config --global cache-dir；迁移到 SSD：composer config -g cache-dir /mnt/ssd/composer-cache。

CI 环境往往以 www、git 或自定义用户运行，它们读的是各自家目录下的 ~/.composer/config.json——你在终端用 root 配的全局镜像，在 CI 里根本没生效。