在 CI/CD 流程中如何缓存和优化 composer install？

通过缓存Composer依赖和优化安装参数可显著缩短CI/CD构建时间。首先在GitHub Actions中缓存~/.composer/cache目录，使用composer.lock哈希值作为缓存key并设置restore-keys提高命中率；确保提交composer.lock文件以锁定版本、避免重复解析；生产环境使用--no-dev、--prefer-dist和--optimize-autoloader参数减少安装耗时并提升类加载效率；谨慎缓存vendor目录以追求极致速度，但需规避跨平台或PHP版本不兼容风险；结合国内镜像如阿里云加速包下载，利用Composer默认并行下载能力，并保持Composer版本更新以获得最佳性能。综合运用这些策略可大幅提升PHP项目CI/CD效率。

在 CI/CD 流程中，composer install 常常是 PHP 项目构建阶段的耗时瓶颈。通过合理缓存依赖和优化安装流程，可以显著缩短构建时间。以下是几种实用策略。

使用持久化缓存目录

Composer 会将下载的包缓存在本地（默认 ~/.composer/cache）。CI 环境中可通过缓存该目录避免重复下载。

以 GitHub Actions 为例：

steps:

- name: Checkout code

uses: actions/checkout@v4

- name: Cache Composer packages

uses: actions/cache@v3

with:

path: ~/.composer/cache

key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}

restore-keys: ${{ runner.os }}-php-

- name: Install dependencies

SCNet智能助手

SCNet超算互联网平台AI智能助手

160

查看详情

run: composer install --no-progress --no-scripts --prefer-dist

关键点：

• 缓存路径为 ~/.composer/cache
• 缓存 key 包含 composer.lock 的哈希值，确保 lock 文件变更时重建缓存
• 设置 restore-keys 提高缓存命中率

锁定依赖版本并提交 composer.lock

确保 composer.lock 文件提交到仓库。这样 CI 安装时直接使用锁定版本，无需重新解析依赖关系，加快安装速度并保证环境一致性。

运行命令：

说明：

• --no-dev：跳过开发依赖（适用于生产构建）
• --prefer-dist：优先使用压缩包而非源码克隆
• --optimize-autoloader：生成更高效的类加载映射

利用 vendor 目录缓存（谨慎使用）

部分 CI 平台支持缓存整个 vendor 目录。虽然能极大提升速度，但需注意以下风险：

• 不同平台或 PHP 版本可能导致二进制不兼容（如扩展包含编译内容）
• 权限或路径问题可能引发运行时错误

建议仅在相同运行环境且严格控制 PHP 版本时使用。

并行安装与镜像加速

使用国内镜像可加快包下载速度，例如阿里云或 Laravel China 镜像：

新版 Composer 默认启用并行下载，无需额外配置。保持使用最新稳定版 Composer 可获得最佳性能。

基本上就这些。合理组合缓存策略和安装参数，能有效降低 CI/CD 中 composer install 的耗时，提升交付效率。

以上就是在 CI/CD 流程中如何缓存和优化 composer install？的详细内容，更多请关注php中文网其它相关文章！