如何在CI/CD流程中缓存Composer依赖以加快构建速度？（GitLab/GitHub Actions示例）

应优先缓存composer全局缓存目录（如~/.composer/cache）而非vendor/，配合–no-scripts –no-autoloader –prefer-dist参数，在gitLab CI用cache关键字、github Actions用actions/cache@v4，以composer.lock哈希为key，可稳定提速50%以上。

在CI/CD中缓存Composer依赖，核心是复用vendor/目录或~/.composer/cache，避免每次构建都重新下载和安装包。关键不是只缓存vendor（因含环境相关文件易出错），而是优先缓存Composer全局缓存目录，并配合--no-scripts --no-autoloader等安全参数。

gitlab CI：用cache关键字缓存Composer全局缓存

GitLab支持基于路径的路径级缓存，适合缓存~/.composer/cache（Composer默认缓存位置）：

• 在.gitlab-ci.yml中为php作业启用cache，指定key: $CI_JOB_NAME或更稳定的composer.lock哈希值
• 使用before_script确保COMPOSER_CACHE_DIR指向缓存路径（如$CI_PROJECT_DIR/.composer-cache），并设COMPOSER_NO_INTERACTION=1
• 运行composer install --no-scripts --no-autoloader --prefer-dist，跳过可能失败的脚本和autoload生成（留到部署阶段）

示例片段：

php-test:   image: php:8.2   before_script:     - export COMPOSER_CACHE_DIR="$CI_PROJECT_DIR/.composer-cache"     - mkdir -p "$COMPOSER_CACHE_DIR"   cache:     key: "$CI_JOB_NAME-composer-cache"     paths:       - "$CI_PROJECT_DIR/.composer-cache"   script:     - composer install --no-scripts --no-autoloader --prefer-dist

GitHub Actions：用actions/cache复用Composer缓存

GitHub官方推荐用actions/cache@v4缓存~/.composer/cache，并用composer install的lock文件哈希作为缓存key：

• 用hashFiles('composer.lock')生成唯一key，确保依赖变更时自动失效缓存
• 设置path: ~/.composer/cache，并提前用composer config --global cache-dir ~/.composer/cache固定路径
• 建议加上--ignore-platform-reqs（若CI PHP版本与本地不一致），但生产构建应尽量保持环境一致

示例步骤：

- name: Cache Composer dependencies   uses: actions/cache@v4   with:     path: ~/.composer/cache     key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}     restore-keys: |       ${{ runner.os }}-composer- 
name: Install dependencies run: composer install --no-scripts --no-autoloader --prefer-dist env: COMPOSER_NO_INTERACTION: 1

进阶技巧：跳过autoload优化冷启动

首次缓存未命中时，composer install仍需解压+安装，可进一步提速：

• 加--classmap-authoritative（发布环境适用），减少运行时类查找开销
• CI中不生成autoload（用--no-autoloader），改用composer dump-autoload --classmap-authoritative单独执行（更可控）
• 若项目含大量私有包，确认auth.json已安全注入（GitLab用variables，GH Actions用secrets），避免认证失败中断缓存

避坑提醒：哪些不该缓存？

以下内容**不要**纳入CI缓存，否则易引发隐性错误：

• vendor/目录本身（含bin/软链接、扩展编译产物，跨环境不兼容）
• composer.lock（它是输入，不是缓存产出；应由开发提交，CI只读取）
• autoload_classmap.php等生成文件（应在构建末尾统一生成，而非复用旧缓存）

基本上就这些。缓存Composer全局目录 + lock哈希key + 安全安装参数，三者配合就能稳定提速50%以上，且不增加维护负担。