在 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中加入：
<include>
<directory suffix=".php">src/</directory>
</include>
</coverage>
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” 里点开就能看。
上传覆盖率到 Coveralls 或 Codecov（可选但推荐）
如果想长期追踪趋势、PR 中自动评论覆盖率变化，推荐接入 Coveralls（免费开源项目友好）：
- 安装
php-coveralls/php-coveralls（dev-only） - 在 workflow 中添加步骤：
vendor/bin/php-coveralls --coverage_clover=build/logs/clover.xml - 确保 PHPUnit 生成 clover 格式：在
phpunit.xml的 <coverage> 下加<report><clover outputFile="build/logs/clover.xml"/></report> - Coveralls 会自动读取
GITHUB_TOKEN，无需额外密钥
跳过低版本 PHP 的覆盖率（避免失败）
PCOV 不支持 PHP < 7.4，Xdebug 在 PHP 8.2+ 默认禁用。稳妥做法是按 PHP 版本条件启用覆盖率：
- PHP 7.4–8.1：用
xdebug（加coverage: xdebug到 setup-php） - PHP 8.2+：用
pcov（加extensions: [pcov]） - PHP 7.3 及以下：跳过
--coverage-*参数，只跑测试
可用 GitHub Actions 的 if 表达式控制，例如：if: matrix.php-version >= '7.4'。
基本上就这些。不需要自建服务器、不用配 webhook，Composer 包开箱即得 CI/CD 级测试反馈和可视化覆盖率——关键是选对工具链（pcov + setup-php + Coveralls），再把配置写清楚。
