@phpstan-consistent-constructornew static() is safe.
References:
- PHPStan phpdocs-basics: Consistent constructor| Analyzer | Version | Result | Diagnostics |
|---|---|---|---|
| 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.
|
| phpstan | 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 | Not enforced reported Lv.0+ | phpdoc_advanced_phpstan_consistent_constructor.php:34: Constructor of class Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor has an unused parameter $id. [identifier=constructor.unusedParameter] [reported-from-level=1] phpdoc_advanced_phpstan_consistent_constructor.php:34: 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(). [identifier=method.childParameterType] [reported-from-level=0] With strict-rulesphpdoc_advanced_phpstan_consistent_constructor.php:34: Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor. [identifier=constructor.missingParentCall] phpdoc_advanced_phpstan_consistent_constructor.php:34: Constructor of class Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor has an unused parameter $id. [identifier=constructor.unusedParameter] phpdoc_advanced_phpstan_consistent_constructor.php:34: 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(). [identifier=method.childParameterType]
Expectation diffLine 34: Unexpected errors ["Constructor of class Conformance\\Tests\\PhpdocAdvancedPhpstanConsistentConstructor\\ChildWithDifferentCtor has an unused parameter $id. [identifier=constructor.unusedParameter] [reported-from-level=1]","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(). [identifier=method.childParameterType] [reported-from-level=0]"] |
| psalm | 6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac next: 7.0.0-beta19 |
Not enforced | No diagnostics reported.
|
| mago | 1.46.0mago 1.46.0 | Not enforced ⚠ 1 false positive | phpdoc_advanced_phpstan_consistent_constructor.php:34: Parameter `$id` of `Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct()` expects type `int` but parent `Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor::__construct()` expects type `string` [incompatible-parameter-type]
Expectation diffLine 34: Unexpected errors ["Parameter `$id` of `Conformance\\Tests\\PhpdocAdvancedPhpstanConsistentConstructor\\ChildWithDifferentCtor::__construct()` expects type `int` but parent `Conformance\\Tests\\PhpdocAdvancedPhpstanConsistentConstructor\\ParentWithCtor::__construct()` expects type `string` [incompatible-parameter-type]"] |
| mir | 0.70.1mir 0.70.1 | Not enforced | No diagnostics reported.
|
| phpantom | 0.9.0phpantom_lsp 0.9.0 | Not enforced | No diagnostics reported.
|
| intelephense | 1.18.5intelephense 1.18.5 | Not enforced | No diagnostics reported.
|
| phpy | 0.2.0phpy 0.2.0 | Not enforced | No diagnostics reported.
|
| qodana | 262.8665.325Qodana 262.8665.325 | Not enforced | No diagnostics reported.
|
| noverify | 0.5.5NoVerify, version 0.5.5: built on: 2025.04.22 14:36:46 OS: r-kuchinskas arm64 Commit: 4774b82f8adc53fbef38f95e97af4b953b4d1529 | Not enforced ⚠ 1 false positive | phpdoc_advanced_phpstan_consistent_constructor.php:34: Missing parent::__construct() call [parentConstructor]
Expectation diffLine 34: Unexpected errors ["Missing parent::__construct() call [parentConstructor]"] |
| steins | 0.1.5steins 0.1.5 (2026-08-12 revision 39b4cc1) | Not enforced | No diagnostics reported.
|
| phpstan-strict | 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 | Not enforced ⚠ 1 false positive | phpdoc_advanced_phpstan_consistent_constructor.php:34: Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ParentWithCtor. [identifier=constructor.missingParentCall] phpdoc_advanced_phpstan_consistent_constructor.php:34: Constructor of class Conformance\Tests\PhpdocAdvancedPhpstanConsistentConstructor\ChildWithDifferentCtor has an unused parameter $id. [identifier=constructor.unusedParameter] phpdoc_advanced_phpstan_consistent_constructor.php:34: 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(). [identifier=method.childParameterType]
Expectation diffLine 34: Unexpected errors ["Conformance\\Tests\\PhpdocAdvancedPhpstanConsistentConstructor\\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\\Tests\\PhpdocAdvancedPhpstanConsistentConstructor\\ParentWithCtor. [identifier=constructor.missingParentCall]","Constructor of class Conformance\\Tests\\PhpdocAdvancedPhpstanConsistentConstructor\\ChildWithDifferentCtor has an unused parameter $id. [identifier=constructor.unusedParameter]","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(). [identifier=method.childParameterType]"] |
| psalm-next | 7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433 | Not enforced | No diagnostics reported.
|
<?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
{
}
}