提高CI构建效率的Composer镜像源配置技巧-composer-PHP中文网

镜像配置不生效是因为repo.packagist键名错误、漏掉composer type值或url末尾缺/，三者缺一即静默回退官方源；验证必须执行composer config -g repo.packagist，输出须为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}这类完整json。

提高ci构建效率的composer镜像源配置技巧

镜像配置不生效，90% 是因为 repo.packagist 键名写错、composer type 值漏掉、或 URL 少了末尾 /——三者缺一即静默回退官方源，且不报错。

验证镜像是否真生效：只看 `composer config -g repo.packagist` 输出

别信“命令跑过了”，必须执行这行命令并检查输出。它必须是完整 JSON 对象，例如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
以下任一情况都说明没生效：

输出为空、null 或 Key "repo.packagist" does not exist
输出是纯字符串如 https://packagist.org（说明 fallback 了）
输出是 https://mirrors.aliyun.com/composer（少斜杠 → 404 路径）

辅助验证可加 -vvv：运行 composer install -vvv 2>&1 | grep "Downloading"，日志中出现的域名必须是镜像站地址，不是 packagist.org。

CI 中全局配置常失效：根本原因是用户权限错位

GitHub Actions 的 runner、GitLab CI 的 git 用户、宝塔的 www 用户，都不会读你本地 ~/.composer/config.json。用 sudo composer config -g 写进 /root/.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

下载

先确认实际执行用户：whoami 或查 CI 日志 UID
给对应用户配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
更稳妥的做法：在项目根目录下运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会写入 composer.json 并被 Git 跟踪

注意：composer config repo.packagist 会全量替换 repositories 字段。若已有私有源，需手动编辑 composer.json，确保 "packagist.org": true（不能设为 false），并在 repositories 数组首位放镜像对象。

换镜像后仍慢？大概率是缓存和参数没配齐

镜像只加速下载环节，但 CI 构建卡顿往往出在缓存路径不对或关键参数缺失。

必须双路径缓存：vendor/（排除 vendor/bin/ 和 vendor/autoload.php） + ~/.composer/cache（推荐设为 $HOME/.composer-cache-$PHP_VERSION 避免多版本污染）
composer install 必须带四个参数：--no-dev、--prefer-dist、--optimize-autoloader、--classmap-authoritative；漏一个，缓存复用率就断崖下跌
换镜像后务必执行：composer clear-cache → 删除 vendor/ 和 composer.lock → composer install --no-cache（否则旧 lock 文件里的哈希仍指向海外源）