通过缓存 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 未变
示例工作流片段：
优化安装命令与环境配置
即使启用了缓存，某些设置仍会影响效率。例如默认情况下 Composer 可能仍会检查更新或写日志。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
建议在 CI 中使用以下选项：
--no-interaction
：非交互模式
--no-progress
：关闭进度条输出
--prefer-dist
：优先使用压缩包而非源码克隆
--optimize-autoloader
：优化自动加载（生产推荐）
完整安装命令示例：
处理平台差异与失效问题
不同运行器
操作系统
（Ubuntu/
mac
OS/Windows）可能导致缓存不兼容。为避免此问题，可在缓存键中加入运行器信息：
这样可防止跨平台缓存污染。同时建议设置 restore-keys 回退到通用缓存，提高命中概率：
基本上就这些。正确配置后，大多数构建都能跳过依赖下载，直接进入测试阶段，速度提升非常明显。关键是保持 lock 文件稳定，并让缓存策略与其联动。
- name: Cache Composer dependencies
uses: actions/cache@v4
with:
path: |
vendor
~/.composer/cache
key: composer-${{ hashFiles('composer.lock') }}
composer install --no-interaction --no-progress --prefer-dist --optimize-autoloader
key: ${{ runner.os }}-composer-${{ hashFiles('composer.lock') }}
restore-keys: |
${{ runner.os }}-composer-