通过缓存 vendor 和 Composer 缓存目录并基于 composer.lock 哈希值生成缓存键，结合 --no-interaction、--prefer-dist 等优化选项，可显著提升 GitHub Actions 中 PHP 项目依赖安装速度，建议在缓存键中加入 runner.os 避免平台冲突，并设置 restore-keys 提高命中率。
在使用 GitHub Actions 构建 PHP 项目时，Composer 依赖安装往往是最耗时的步骤之一。通过合理配置缓存策略，可以显著缩短 CI/CD 执行时间。关键是精准识别缓存键和缓存路径，并确保缓存命中率高。
理解 Composer 缓存机制
Composer 在运行时会将下载的包缓存在本地目录（通常是 ~/.composer/cache），但 CI 环境每次都是干净启动，如果不做处理，每次都会重新下载所有依赖。GitHub Actions 提供了 actions/cache 动作，可用来保存和恢复这些文件。
实际更推荐缓存整个 vendor 目录和 Composer 缓存目录，结合 composer.lock 文件内容生成缓存键，这样能避免不必要的重装。
基于 composer.lock 的精准缓存
缓存应基于 composer.lock 文件的哈希值来创建唯一键，只要 lock 文件不变，就复用已有缓存。这能确保依赖一致性，同时提升命中率。
- 使用 hashFiles('composer.lock') 生成缓存键
- 缓存路径包括项目根目录下的 vendor 和用户目录下的 ~/.composer/cache
- 恢复缓存后跳过 composer install 如果 vendor 已存在且 lock 未变
示例工作流片段：
- name: Cache Composer dependencies
uses: actions/cache@v4
with:
path: |
vendor
~/.composer/cache
key: composer-${{ hashFiles('composer.lock') }}
优化安装命令与环境配置
即使启用了缓存，某些设置仍会影响效率。例如默认情况下 Composer 可能仍会检查更新或写日志。
建议在 CI 中使用以下选项：
- --no-interaction：非交互模式
- --no-progress：关闭进度条输出
- --prefer-dist：优先使用压缩包而非源码克隆
- --optimize-autoloader：优化自动加载（生产推荐）
完整安装命令示例：
composer install --no-interaction --no-progress --prefer-dist --optimize-autoloader
处理平台差异与失效问题
不同运行器操作系统（Ubuntu/macOS/Windows）可能导致缓存不兼容。为避免此问题，可在缓存键中加入运行器信息：
key: ${{ runner.os }}-composer-${{ hashFiles('composer.lock') }}
这样可防止跨平台缓存污染。同时建议设置 restore-keys 回退到通用缓存，提高命中概率：
restore-keys: |
${{ runner.os }}-composer-
基本上就这些。正确配置后，大多数构建都能跳过依赖下载，直接进入测试阶段，速度提升非常明显。关键是保持 lock 文件稳定，并让缓存策略与其联动。
