启用GitLab缓存并设置COMPOSER_CACHE_DIR,结合PHP版本或composer.lock生成缓存键,使用--prefer-dist和--no-dev选项,可显著加速Composer安装。

在GitLab CI/CD中运行PHP项目时,Composer安装依赖通常是流水线中最耗时的步骤之一。每次构建都从头下载所有包会显著拖慢流程。通过合理使用缓存策略,可以大幅减少重复下载,提升CI效率。以下是几种实用方法。
启用GitLab缓存机制
GitLab CI/CD支持通过cache关键字保存和复用文件夹或文件。对Composer而言,最有效的做法是缓存其全局包目录(默认为~/.composer/cache)。
在.gitlab-ci.yml中配置如下:
cache:
key: composer-cache
paths:
- ~/.composer/cache/files这样,Composer下载的压缩包会被保留,下次构建时直接复用,避免重复网络请求。
结合COMPOSER_CACHE_DIR环境变量
某些Runner环境可能权限受限,无法访问用户主目录。可自定义缓存路径并设置环境变量:
variables:
COMPOSER_CACHE_DIR: ${CI_PROJECT_DIR}/.cache/composer
cache:
key: ${CI_JOB_NAME}
paths:
- .cache/composer
此方式将缓存放在项目目录下,更易控制且兼容大多数Runner类型。
按PHP版本或依赖文件分组缓存
若项目在多个PHP版本下测试,应避免不同版本共享同一缓存。可通过组合变量创建差异化缓存键:
cache:
key: $CI_JOB_NAME-$PHP_VERSION
paths:
- .cache/composer或根据composer.lock内容生成唯一键,确保依赖变更时自动失效旧缓存:
cache:
key:
files:
- composer.lock
paths:
- .cache/composer使用--prefer-dist与--no-dev优化安装
在非生产构建中,若不需要开发依赖,使用:
- composer install --prefer-dist --no-dev:优先使用预打包dist资源,更快且更稳定
- composer install --prefer-dist:完整安装,仍利用缓存加速
--prefer-dist能跳过源码克隆,直接解压缓存中的zip包,进一步缩短时间。
基本上就这些。合理配置缓存路径、环境变量和缓存键策略,再配合Composer安装选项,可让CI中的依赖安装从几十秒降至几秒。关键是保持缓存一致性,同时确保变更生效。










