在 GitHub Actions 中缓存 composer 依赖的最佳实践_网络技术

在 GitHub Actions 中缓存 composer 依赖的最佳实践

发布时间 - 2025-11-10 00:00:00 点击率：次

使用 actions/cache 缓存 vendor 和 ~/.composer/cache 目录，基于 composer.lock 哈希生成 key，结合 restore-keys 提升命中率，确保 CI/CD 高效稳定。

在 GitHub Actions 中缓存 Composer 依赖可以显著加快 PHP 项目的 CI/CD 构建速度，避免每次都要重新下载所有依赖。关键是正确配置缓存键和恢复策略，确保命中率高且不会因缓存不一致导致问题。

使用 actions/cache 正确缓存 vendor 目录

Composer 安装的依赖默认放在 vendor 目录中，而依赖关系由 composer.lock 文件锁定。缓存应基于 lock 文件的哈希值来生成 key，这样只有当依赖变更时才重建缓存。

示例工作流片段：

- name: Cache Composer dependencies
  uses: actions/cache@v4
  with:
    path: vendor
    key: ${{ runner.os }}-composer-${{ hashFiles('composer.lock') }}
    restore-keys: |
      ${{ runner.os }}-composer-

说明：

path: vendor 指定缓存实际安装的依赖目录
key 包含操作系统和 lock 文件内容哈希，确保环境与依赖一致
restore-keys 提供降级匹配机制，比如 lock 文件变更后可尝试使用旧缓存加速部分下载

同时缓存 Composer 的全局缓存目录（推荐）

除了 vendor 目录，Composer 自身会缓存包文件（如 zip 归档）在全局目录中。缓存这个路径能进一步提升性能，尤其是跨多个项目或 job 时。

可添加第二个缓存步骤：

- name: Cache Composer cache
  uses: actions/cache@v4
  with:
    path: ~/.composer/cache
    key: ${{ runner.os }}-composer-cache-${{ hashFiles('composer.lock') }}

这会缓存已下载的包归档，减少网络请求。注意该缓存 key 不需要 restore-keys，因为它是辅助性的。

确保 composer install 正确执行

即使有缓存，也应保证构建逻辑正确。建议使用以下命令：

- name: Install dependencies
if: steps.cache-composer-dependencies.outputs.cache-hit != 'true'
run: composer install --no-progress --no-scripts --prefer-dist

或者更常见的是无条件运行 composer install，但启用 --prefer-dist 和 --no-dev（如为生产构建），并让 Composer 利用已有的 vendor 目录智能判断是否重装。

如果 vendor 已存在且 lock 文件未变，Composer 通常会跳过重复安装。

注意事项与最佳实践

始终提交 composer.lock 文件，这是缓存有效的前提
避免缓存整个项目目录，只缓存必要的路径（vendor、~/.composer/cache）
定期清理旧缓存，GitHub 会自动管理，但可通过 UI 手动清除损坏缓存
若使用私有包，确保认证已配置（如通过 COMPOSER_AUTH 环境变量）
不同 PHP 版本或扩展组合可能导致兼容问题，可在 key 中加入 PHP 版本标识（如 ${{ matrix.php-version }}）

基本上就这些。合理利用缓存键和分层缓存策略，能大幅缩短构建时间，同时保持可靠性。

# php # git # composer # github # 操作系统 # 环境变量 # if # ui # 的是 # 这是 # 放在 # 尤其是 # 都要 # 多个 # 不需要 # 工作流 # 目录中 # 它是

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：1千焦等于多少卡路里 100千焦热量高吗【健身】

下一篇：客户信息收集技巧

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：1千焦等于多少卡路里 100千焦热量高吗【健身】

下一篇：客户信息收集技巧