怎样解决Composer加载慢导致的CI/CD延时？利用缓存镜像提速！-composer-PHP中文网

ci/cd中composer安装慢主因是镜像未配对、缓存路径错误、参数未锁死；须执行composer config -g repo.packagist确认输出为https://mirrors.aliyun.com/composer/，加-vvv验证日志含镜像域名，项目级配置更可靠，缓存~/.composer/cache而非vendor，ci必用--no-dev --prefer-dist --optimize-autoloader --classmap-authoritative组合。

怎样解决composer加载慢导致的ci/cd延时？利用缓存镜像提速！

CI/CD 里 Composer 安装慢，90% 是镜像没配对、缓存路径写错、安装参数没锁死——三者缺一，提速就失效。

确认镜像源是否真生效

执行 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 字段安全追加，不覆盖已有私有源。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

适合 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 场景下必须固定安装行为：--no-dev --prefer-dist --optimize-autoloader --classmap-authoritative 是最稳组合。

--prefer-dist：强制下载 ZIP 包，跳过 Git clone（尤其对只有 dev-main 分支的包至关重要）
--no-dev：跳过 require-dev 里的全部包（PHPUnit、PHPStan 等占体积和时间大头）
--optimize-autoloader 和 --classmap-authoritative：跳过动态类查找，提升运行时性能，也减少 install 阶段 autoload 生成耗时
千万别漏 composer clear-cache ——旧缓存可能残留国外源的元数据，不清理，Composer 仍会尝试从旧地址拉取校验信息

最容易被忽略的点是：镜像只加速「元数据拉取」和「zip 包下载」，不解决 Resolving dependencies 卡顿、autoload 生成慢、或 PHP 内存不足的问题。如果换源+缓存+参数都对了，还卡在这个阶段，就得查 COMPOSER_MEMORY_LIMIT、xdebug.mode 或 platform 配置了。