为CI CD流水线注入Composer镜像加速的完整教程-composer-PHP中文网

必须执行composer config -g repo.packagist确认输出为https://mirrors.aliyun.com/composer/等国内镜像url，为空或仍显示packagist.org说明未生效；ci中需用--no-dev --prefer-dist --optimize-autoloader --classmap-authoritative等参数组合，并缓存~/.composer/cache而非vendor。

为ci cd流水线注入composer镜像加速的完整教程

CI/CD 里 Composer 下载慢，不是网络问题，是没配对镜像源、没管缓存路径、没锁安装参数——三者缺一，提速就打折扣。

怎么确认镜像源真生效了

执行 composer config -g repo.packagist，输出必须是类似 https://mirrors.aliyun.com/composer/ 的 URL。如果为空、null 或仍是 https://packagist.org，说明配置没落进实际运行命令的用户环境里。

CI 脚本里用 sudo composer config -g，很可能写进了 root 的 ~/.composer/config.json，但构建容器里跑的是 runner 用户，根本读不到
拼错字段名（比如写成 repos.packagist 多了个 s）会静默失败，composer config -g repo.packagist 查出来还是空
验证是否真走镜像：加 -vvv 运行 composer install，日志里出现 GET https://mirrors.aliyun.com/composer/p2/... 才算成功

项目级配置比全局配置更可靠

在项目根目录运行：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/。它会自动往 composer.json 的 repositories 字段安全追加，不覆盖已有私有源。

Discussion Composer

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

下载

适合 CI 场景：配置随代码提交，所有人行为一致，避免不同镜像混用导致 hash 不一致
如果 composer.json 里已有 "repositories": []（数组格式），命令会报错；得先手动改成 "repositories": {}（对象）再执行
别手写 "packagist.org": false —— 这会彻底关掉官方源，镜像临时不可用时，composer install 直接失败
换源后首次 install 若报 hash 校验失败，删掉 vendor/ 和 composer.lock 重来即可

缓存 ~/.composer/cache，别缓存 vendor/

vendor/ 缓存看似快，实则危险：不同 PHP 版本、扩展或 OS 下生成的 autoloader 不能混用，缓存错版本会导致 Class not found 或 Cannot declare class。

真正该缓存的是 ~/.composer/cache —— 它只跟 composer.lock 哈希绑定，与环境无关
GitHub Actions 示例：path: ~/.composer/cache，key: ${{ runner.os }}-php-${{ matrix.php }}-composer-${{ hashFiles('**/composer.lock') }}
GitLab CI 示例：cache: key: ${PHP_VERSION}-composer-cache; paths: - ~/.composer/cache
缓存失效最常见原因：本地生成了新 composer.lock 但没提交，导致 key 不匹配

CI 中必须用的安装参数组合

CI 部署命令应为：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-scripts --no-progress。漏掉任一关键项，都可能让构建变慢或出 runtime 错误。

--prefer-dist：强制走 zip 包下载，避开 Git clone、SSH 密钥、协议阻塞等问题
--optimize-autoloader + --classmap-authoritative：编译 PSR-4 映射为静态数组，并禁用 file_exists() 探测，autoload 性能提升数倍
--no-dev：跳过 require-dev，减小体积、缩短时间；测试阶段可单独保留
--no-scripts：防止 post-install-cmd 等钩子在 CI 中意外执行耗时操作（如前端构建）