如何为你的Composer包配置自动化测试和代码覆盖率报告？（GitHub Actions）

在 GitHub Actions 中为 Composer 包配置自动化测试和覆盖率报告，核心是运行 PHPUnit 测试、生成 HTML 或 Clover 格式报告，并上传至 GitHub Artifacts 或 Coveralls；推荐使用 pcov（PHP 8 兼容）、shivammathur/setup-php 动作及条件化启用覆盖率。

直接在 GitHub Actions 中为 Composer 包配置自动化测试和代码覆盖率报告，核心是三件事：用 phpunit 运行测试、生成覆盖率（推荐 phpcov 或 PHPUnit 原生 HTML 报告）、把结果上传到 GitHub 或存为产物。下面是最实用、开箱即用的配置方式。

确保项目已支持 PHPUnit 和覆盖率工具

你的包必须有 phpunit.xml（或 phpunit.xml.dist），且已安装 PHPUnit（建议 9.5+ 或 10.x）和 php-coveralls / pcov / xdebug 之一。推荐优先用 pcov（轻量、快、PHP 8 兼容好）：

• 在 composer.json 的 require-dev 中加："pcov/pcov": "^1.0"
• 运行 composer install 后，确认 pcov 可用：php -m | grep pcov
• PHPUnit 配置里启用覆盖率，例如在 phpunit.xml 中加入：

GitHub Actions 工作流：测试 + 本地覆盖率报告

创建 .github/workflows/test.yml，使用官方 shivammathur/setup-php 动作可一键启用 pcov 并装好依赖：

• 指定 PHP 版本（如 8.1、8.2、8.3）和扩展：extensions: [pcov]
• 运行 composer install → vendor/bin/phpunit --coverage-html=coverage
• 用 actions/upload-artifact 保存 coverage/ 目录，方便手动下载查看

这样每次 push 或 PR 都会生成可浏览的 HTML 覆盖率报告，放在 Actions 的 “Artifacts” 里点开就能看。

标签： php html js git json composer github 工具 red