如何在 GitHub Actions 工作流中正确配置和使用 Composer？

在 GitHub Actions 中正确配置 Composer 需确保 PHP 环境就绪、启用缓存加速、安全执行安装并处理私有包等实际需求，推荐使用 shivammathur/setup-php 动作安装指定版本 PHP 与 Composer，并配合 actions/cache 缓存 ~/.composer/cache 目录，键值包含 composer.lock 哈希，安装时使用 --no-interaction --no-progress --prefer-dist --optimize-autoloader 等参数保障安全与性能。

在 GitHub Actions 中正确配置 Composer，关键是确保 PHP 环境就绪、缓存依赖提升速度、避免权限或路径问题，并适配项目实际需求（如私有包、特定 PHP 版本或 Composer 版本）。

安装 PHP 和 Composer

GitHub Actions 默认不包含 PHP，需显式安装。推荐使用 shivammathur/setup-php 动作，它自动安装 PHP、Composer 及常用扩展，并支持版本锁定和扩展启用。

• 指定 PHP 版本（如 8.2）和扩展（如 mbstring, curl, xml）
• 该动作会自动安装最新稳定版 Composer；如需特定版本（如 2.5.8），可加参数 composer-version: '2.5.8'
• 避免手动用 curl -sS https://getcomposer.org/installer | php，易出错且绕过缓存机制

启用 Composer 缓存加速构建

Composer 安装耗时主要来自下载包，利用 actions/cache 缓存 ~/.composer/cache 目录可大幅缩短后续运行时间（通常减少 60%+）。

• 缓存键应包含 composer.lock 的哈希值，确保依赖变更时缓存自动失效：
  key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
• 若无 composer.lock（如仅开发环境），可用 composer.json 哈希，但稳定性略低
• 缓存步骤必须放在 setup-php 之后、composer install 之前

安全执行安装与验证

默认 composer install 在 CI 中应禁用交互、跳过脚本、校验签名，防止意外行为或安全风险。

标签： php js git json composer github curl ai 环境变量 gitlab 常见问题 开发环