如何在Composer中使用GitHub Actions缓存来加速构建_actions/cache与Composer的完美结合-composer-PHP中文网

如何在Composer中使用GitHub Actions缓存来加速构建_actions/cache与Composer的完美结合

冰火之心

发布： 2025-12-05 17:07:12

原创

675人浏览过

答案：通过 GitHub Actions 的 actions/cache@v4 缓存 Composer 依赖和 vendor 目录，基于 composer.lock 生成缓存键，可显著加速 PHP 项目构建，建议结合操作系统和 PHP 版本信息优化缓存命中率。

如何在composer中使用github actions缓存来加速构建_actions/cache与composer的完美结合

在使用 Composer 构建 PHP 项目时，依赖安装（composer install）往往是最耗时的步骤之一。特别是在 CI/CD 环境中，每次构建都从远程拉取所有包会显著拖慢流程。通过将 GitHub Actions 的 @actions/cache 与 Composer 结合，可以有效复用已下载的依赖包和已生成的自动加载文件，大幅缩短构建时间。

理解 Composer 的缓存路径

Composer 在运行过程中会将下载的包、元信息和日志等存储在本地缓存目录中。默认情况下，这个目录位于：

~/.composer/cache

在 GitHub Actions 的 Linux 运行器中，用户主目录为 /home/runner，因此完整路径是：

/home/runner/.composer/cache

缓存该目录后，后续构建可以直接复用之前下载的压缩包（dist files）、源码克隆（source clones）以及已解析的版本信息，避免重复网络请求。

配置 GitHub Actions 缓存策略

要在工作流中启用缓存，需在 YAML 文件中添加 actions/cache@v4 步骤，并指定缓存路径与缓存键（cache key）。以下是一个典型配置示例：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
<pre class="brush:php;toolbar:false;">  - name: Cache Composer packages
    id: composer-cache
    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-progress

登录后复制

Convai Technologies Inc.

对话式 AI API，用于设计游戏和支持端到端的语音交互

查看详情

说明：

path：指定要缓存的目录，即 Composer 缓存路径。
key：基于操作系统和 composer.lock 文件内容生成唯一键。只要 lock 文件不变，就命中缓存。
restore-keys：提供模糊匹配回退机制。若精确键未命中，尝试恢复以 ${{ runner.os }}-composer- 开头的缓存。

进一步优化：缓存 vendor 目录（可选）

除了 Composer 自身缓存，还可以直接缓存项目根目录下的 vendor 文件夹和自动加载优化结果。这种方式更激进，但需注意兼容性：

- name: Cache Vendor Directory
  uses: actions/cache@v4
  with:
    path: |
      vendor
      bootstrap/cache/*.php
    key: ${{ runner.os }}-vendor-${{ hashFiles('**/composer.lock') }}

登录后复制

搭配以下命令使用效果更佳：

composer install --no-progress --optimize-autoloader --classmap-authoritative

这样可跳过整个依赖安装过程，前提是 lock 文件和 PHP 版本完全一致。