Agent-Skills.md

Agent Skills: PHP Testing

Write unit and integration tests for PHP applications with PHPUnit and Pest. Use when writing PHPUnit unit tests or integration tests for PHP applications. (triggers: tests/**/*.php, phpunit.xml, phpunit, pest, mock, assert, tdd)

UncategorizedID: hoangnguyen0403/agent-skills-standard/php-testing

Repository

hoangnguyen0403/agent-skills-standard
HoangNguyen0403License: Apache-2.0
362103

Install this agent skill to your local

pnpm dlx add-skill https://github.com/HoangNguyen0403/agent-skills-standard/tree/HEAD/skills/php/php-testing

Skill Files

Browse the full folder contents for php-testing.

Download Skill

Loading file tree…

skills/php/php-testing/SKILL.md

Skill Metadata

Name
php-testing
Description
"Write unit and integration tests for PHP applications with PHPUnit and Pest. Use when writing PHPUnit unit tests or integration tests for PHP applications. (triggers: tests/**/*.php, phpunit.xml, phpunit, pest, mock, assert, tdd)"

PHP Testing

Priority: P1 (HIGH)

Structure

See implementation examples for test directory layout.

Write Tests with PHPUnit and Pest

  • Standards: Use PHPUnit (9/10+) or Pest. Organize into Unit/, Integration/, and Feature/. Class names should extend TestCase.
  • TDD Workflow: Follow Red-Green-Refactor. Write failing test first, implement minimal logic, then refactor.

See implementation examples for PHPUnit service test with mock.

Apply Assertions and Data Providers

  • Fluent Assertions: Use assertSame (===) over assertEquals to avoid type coercion. Also use assertCount() and assertMatchesRegularExpression().
  • Data Providers: Use #[DataProvider('statusProvider')] (PHPUnit 10+) or dataset (Pest).

See implementation examples for Pest expressive syntax with datasets.

Isolate Test Dependencies

  • Mocking: Use createMock() for dependencies. DO NOT mock simple Data Objects.
  • Isolation: Ensure tests are Independent and Repeatable. DB tests must use Transactions or SQLite :memory:.
  • Coverage: Aim for 80%+ line coverage. Use phpunit.xml to whitelist specific directories.
  • Automation: Run tests on every PR using GitHub Actions or GitLab CI.

Anti-Patterns

  • No testing private methods: Test through public interfaces only.
  • No over-mocking internals: Mock only external boundaries.
  • No real network/DB in unit tests: Use in-memory databases or mocks.
  • No coverage-metric chasing: Prioritize meaningful assertions.

References