• PHPStan
• PHPStan-PHPUnit extension

This extension provides highly opinionated and strict rules for test cases for the PHPStan static analysis tool.

Run

$ composer require --dev brainbits/phpstan-rules

All of the rules provided by this library are included in rules.neon.

When you are using phpstan/extension-installer, rules.neon will be automatically included.

Otherwise you need to include rules.neon in your phpstan.neon:

# phpstan.neon
includes:
    - vendor/brainbits/phpstan-rules/rules.neon

This package provides the following rules for use with phpstan/phpstan:

• BrainbitsPhpStan\CoversClassExistsRule
• BrainbitsPhpStan\CoversClassPresentRule

This rule checks that classes that are covered by @covers annotation or #[CoversClass] attribute exist.

This rule forces you to specify either a @covers annotation or #[CoversClass], #[CoversFunction] or #[CoversNothing] attributes in unit tests.

Why:

1. It prevents code coverage sums to show higher values than expected.

❌

// tests/ExampleTestCase/Unit/MyInvalidClassTest.php
namespace ExampleTestCase\Unit;

final class MyInvalidClassTest extends \PHPUnit\Framework\TestCase {}

✅

// tests/ExampleTestCase/Unit/MyClassTest.php
namespace ExampleTestCase\Unit;

#[\PHPUnit\Framework\Attributes\CoversClass(MyClass::class)]
final class MyClassTest extends \PHPUnit\Framework\TestCase {}

• By default, this rule treats a class as a unit test if it extends another class, its namespace contains the string Unit and its name ends with Test. The parent class itself is not checked.

If you want to change the namespace string check described above, you can set your own string to be checked in the unitTestNamespaceContainsString parameter.

# phpstan.neon
parameters:
    brainbits:
        unitTestNamespaceContainsString: CustomTestPath