Documentation version: nextdevelopment documentation
Skip to content

GitHub Actions coverage recipe ​

Register the PHPUnit extension and set coverage.report_output['markdown'] in the root gesso.php; when the job exposes GITHUB_STEP_SUMMARY, the extension appends the same Markdown report to it automatically:

php
'coverage' => ['report_output' => ['markdown' => 'build/openapi-coverage.md']],

Then preserve the same report as a workflow artifact:

yaml
- name: Run contract tests
  run: vendor/bin/phpunit

- name: Upload OpenAPI coverage
  if: always()
  uses: actions/upload-artifact@v4
  with:
    name: openapi-coverage
    path: build/openapi-coverage.md

GitHub renders the summary on the workflow run page while the artifact remains downloadable. Add a coverage threshold when missing operations should fail CI.