Composer导出加速的缓存使用技巧-composer-PHP中文网

composer导出慢主因是cache-files-dir未配置或未命中，必须显式设置并验证；导出需用--no-dev --prefer-dist --no-autoloader --no-scripts --no-interaction组合，且镜像源三要素（键名、type、url末尾/）缺一不可。

composer导出加速的缓存使用技巧

Composer 导出（composer install --no-dev --prefer-dist）慢，不是因为没缓存，而是缓存没被正确命中或没被导出场景真正复用。 默认的 cache-dir 下混着元数据、VCS、解压归档，但只有 files/ 子目录里的 ZIP 包能离线复用——而导出阶段恰恰只依赖它。

确认 cache-files-dir 是否生效

很多人设了 cache-dir 就以为缓存到位了，其实它只是个“总目录”，里面包含 repo/、vcs/、archived/ 等多个子模块，只有 files/ 下的 ZIP 才能在断网或 CI 复用。必须单独配置 cache-files-dir：

先清掉旧配置：composer config --global --unset cache-dir（避免冲突）
指定纯 ZIP 缓存路径：composer config --global cache-files-dir /opt/composer-cache/files
验证是否写入：ls -l /opt/composer-cache/files/monolog/monolog/，应能看到类似 2.10.0.0/monolog-monolog-6a8c4b5.zip 的结构
若路径下为空，说明下载时没走 --prefer-dist，或镜像源配错导致 fallback 到 packagist.org

导出命令必须带 --prefer-dist 且禁用 autoload

composer install 默认可能走 git clone（尤其私有包或 dev- 版本），跳过 ZIP 缓存；而 --prefer-dist 强制走压缩包下载，才能命中 cache-files-dir。同时，导出环境不需要自动加载器生成：

Discussion Composer

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

下载

正确组合：composer install --no-dev --prefer-dist --no-autoloader --no-scripts --no-interaction
漏掉 --no-autoloader 会导致生成 vendor/autoload.php 和 classmap，浪费 IO 且无意义
漏掉 --no-scripts 可能触发 post-install-cmd（如 Laravel 的 php artisan optimize:clear），拖慢导出节奏

CI 中挂载缓存要精准到 files/ 目录

GitHub Actions、GitLab CI 等常挂载整个 ~/.composer/cache，但实际只需 files/。挂错路径等于白搭：

GitHub Actions 示例：actions/cache@v4 的 path 应设为 ~/.composer/cache/files，key 建议含 composer.lock-hash 或 PHP_VERSION
Docker 构建中，不要只 VOLUME ["/root/.composer/cache"]，而应在构建前 COPY 已预热的 files/ 目录
若用 COMPOSER_CACHE_DIR 环境变量，它只影响 cache-dir，不控制 cache-files-dir——后者必须用 composer config 显式设置

镜像源配错一个字符，缓存就完全失效

镜像配置不是“差不多就行”，三要素缺一不可，否则静默回退到 packagist.org，所有缓存策略归零：

键名必须是 repo.packagist（单数，不是 repos.packagist）
type 字段必须显式写 "type": "composer"（旧版 Composer 1.x 需用 repos.packagist + JSON 字符串）
URL 必须 HTTPS 开头 + 末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）
验证命令：composer config -g repo.packagist 输出必须是完整 JSON 对象，不能是字符串或空

真正容易被忽略的是：缓存本身没问题，但 files/ 目录没被挂载、没被复制、或根本没生成 ZIP —— 这些比调参数更决定导出成败。