• Install now

Rule php_unit_attributes

PHPUnit attributes must be used over their respective PHPDoc-based annotations.

Examples

Example #1

--- Original
+++ New
 <?php
 /**
- * @covers \VendorName\Foo
  * @internal
  */
+#[\PHPUnit\Framework\Attributes\CoversClass(\VendorName\Foo::class)]
 final class FooTest extends TestCase {
     /**
      * @param int $expected
      * @param int $actual
-     * @dataProvider giveMeSomeData
-     * @requires PHP 8.0
      */
+    #[\PHPUnit\Framework\Attributes\DataProvider('giveMeSomeData')]
+    #[\PHPUnit\Framework\Attributes\RequiresPhp('8.0')]
     public function testSomething($expected, $actual) {}
 }

References

• Fixer class: PhpCsFixer\Fixer\PhpUnit\PhpUnitAttributesFixer

• Test class: PhpCsFixer\Tests\Fixer\PhpUnit\PhpUnitAttributesFixerTest

The test class defines officially supported behaviour. Each test case is a part of our backward compatibility promise.