• Install now

Rule php_unit_test_case_static_method_calls

Calls to PHPUnit\Framework\TestCase static methods must all be of the same type, either $this->, self:: or static::.

Warnings

This rule is RISKY

Risky when PHPUnit methods are overridden or not accessible, or when project has PHPUnit incompatibilities.

This rule is CONFIGURABLE

You can configure this rule using the following options: call_type, methods, target.

Configuration

call_type

The call type to use for referring to PHPUnit methods.

Allowed values: 'self', 'static' and 'this'

Default value: 'static'

methods

Dictionary of method => call_type values that differ from the default strategy.

Allowed types: array<string, string>

Default value: []

target

Target version of PHPUnit.

Allowed values: '10.0', '11.0' and 'newest'

Default value: '10.0'

Examples

Example #1

Default configuration.

--- Original
+++ New
 <?php
 final class MyTest extends \PHPUnit_Framework_TestCase
 {
     public function testMe()
     {
-        $this->assertSame(1, 2);
-        self::assertSame(1, 2);
+        static::assertSame(1, 2);
+        static::assertSame(1, 2);
         static::assertSame(1, 2);
         static::assertTrue(false);
     }
 }

Example #2

With configuration: ['call_type' => 'this'].

--- Original
+++ New
 <?php
 final class MyTest extends \PHPUnit_Framework_TestCase
 {
     public function testMe()
     {
         $this->assertSame(1, 2);
-        self::assertSame(1, 2);
-        static::assertSame(1, 2);
-        static::assertTrue(false);
+        $this->assertSame(1, 2);
+        $this->assertSame(1, 2);
+        $this->assertTrue(false);
     }
 }

Example #3

With configuration: ['methods' => ['assertTrue' => 'this']].

--- Original
+++ New
 <?php
 final class MyTest extends \PHPUnit_Framework_TestCase
 {
     public function testMe()
     {
-        $this->assertSame(1, 2);
-        self::assertSame(1, 2);
         static::assertSame(1, 2);
-        static::assertTrue(false);
+        static::assertSame(1, 2);
+        static::assertSame(1, 2);
+        $this->assertTrue(false);
     }
 }

Rule sets

The rule is part of the following rule sets:

• @PHPUnit11x0Migration:risky with config:

  ['target' => '11.0']

• @PhpCsFixer:risky with config:

  ['call_type' => 'self']

References

• Fixer class: PhpCsFixer\Fixer\PhpUnit\PhpUnitTestCaseStaticMethodCallsFixer

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

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