← All results

@phpstan-consistent-constructor

Group: Advanced PHPDoc types · Category: ecosystem · File: phpdoc_advanced_phpstan_consistent_constructor.php

Without the tag, PHP allows subclasses to change the constructor signature. With the tag, children must stay compatible so new static() is safe. References: - PHPStan phpdocs-basics: Consistent constructor

Analyzer results

AnalyzerVersionResultDiagnostics
phan 6.0.7Phan 6.0.7 php-ast version 1.1.3 PHP version used to run Phan: 8.5.9 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpstan 2.2.11PHPStan - PHP Static Analysis Tool 2.2.11 Enforced reported Lv.0+
phpdoc_advanced_phpstan_consistent_constructor.php:39: Constructor of class Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor has an unused parameter $id. [reported-from-level=1]
phpdoc_advanced_phpstan_consistent_constructor.php:39: Parameter #1 $id (int) of method Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() is not contravariant with parameter #1 $name (string) of method Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor::__construct(). [reported-from-level=0]
With strict-rules
phpdoc_advanced_phpstan_consistent_constructor.php:39: Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor.
phpdoc_advanced_phpstan_consistent_constructor.php:39: Constructor of class Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor has an unused parameter $id.
phpdoc_advanced_phpstan_consistent_constructor.php:39: Parameter #1 $id (int) of method Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() is not contravariant with parameter #1 $name (string) of method Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor::__construct().
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
psalm 6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac
next: 7.0.0-beta19
Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
mago 1.47.4mago 1.47.4 Enforced
phpdoc_advanced_phpstan_consistent_constructor.php:39: Parameter `$id` of `Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct()` expects type `int` but parent `Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor::__construct()` expects type `string` [incompatible-parameter-type]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
mir 0.72.1mir 0.72.1 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpantom 0.10.0phpantom_lsp 0.10.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
intelephense 1.18.5intelephense 1.18.5 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpactor 2026.07.22.0Phpactor 2026.07.22.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpy 0.2.0phpy 0.2.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
qodana 262.9437.196Qodana 262.9437.196 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
noverify 0.5.5NoVerify, version 0.5.5: built on: 2025.04.22 14:36:46 OS: r-kuchinskas arm64 Commit: 4774b82f8adc53fbef38f95e97af4b953b4d1529 Enforced
phpdoc_advanced_phpstan_consistent_constructor.php:39: Missing parent::__construct() call [parentConstructor]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
steins 0.1.6steins 0.1.6 (2026-08-25 revision c13b4c7) Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpstan-strict 2.2.11PHPStan - PHP Static Analysis Tool 2.2.11 Enforced
phpdoc_advanced_phpstan_consistent_constructor.php:39: Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor.
phpdoc_advanced_phpstan_consistent_constructor.php:39: Constructor of class Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor has an unused parameter $id.
phpdoc_advanced_phpstan_consistent_constructor.php:39: Parameter #1 $id (int) of method Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() is not contravariant with parameter #1 $name (string) of method Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor::__construct().
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
psalm-next 7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor;

/**
 * Cross-tool handling of `@phpstan-consistent-constructor`.
 *
 * Without the tag, PHP allows subclasses to change the constructor signature.
 * With the tag, children must stay compatible so `new static()` is safe.
 *
 * References:
 * - PHPStan phpdocs-basics: Consistent constructor
 */

/**
 * @phpstan-consistent-constructor
 */
class ParentWithCtor // T: @phpstan-consistent-constructor
{
    public function __construct(string $name)
    {
        // Use the parameter so unused-parameter rules stay quiet.
        if ($name === '') {
            throw new \InvalidArgumentException('empty name');
        }
    }
}

// Compatible: inherits the parent's constructor, so the tag must stay silent.
final class ChildWithInheritedCtor extends ParentWithCtor // V
{
}

// Divergent constructor: rejected only when the parent requires consistency.
final class ChildWithDifferentCtor extends ParentWithCtor
{
    public function __construct(int $id) // E?: not compatible with ParentWithCtor::__construct under @phpstan-consistent-constructor
    {
    }
}