@phpstan-consistent-constructornew static() is safe.
References:
- PHPStan phpdocs-basics: Consistent constructor| Analyzer | Version | Result | Diagnostics |
|---|---|---|---|
| phan | 6.0.10Phan 6.0.10 php-ast version 1.1.3 PHP version used to run Phan: 8.5.11 | Not enforced | No diagnostics reported.
|
| phpstan | 2.3.1PHPStan - PHP Static Analysis Tool 2.3.1 | 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-rulesphpdoc_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().
|
| psalm | 6.20.0Psalm 6.20.0@804f03c0c183d149fcd4b8c7c0c9b3fbf836d34c next: 7.0.0-rc2 |
Not enforced | No diagnostics reported.
|
| mago | 1.57.0mago 1.57.0 | 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]
|
| mir | 0.87.0mir 0.87.0 | Not enforced | No diagnostics reported.
|
| phpantom | 0.11.1phpantom_lsp 0.11.1 | Not enforced | No diagnostics reported.
|
| intelephense | 1.18.5intelephense 1.18.5 | Not enforced | No diagnostics reported.
|
| phpactor | 2026.10.07.0Phpactor 2026.10.07.0 | Not enforced | No diagnostics reported.
|
| phpy | 1.0.19409phpy 1.0.19409 | Not enforced | No diagnostics reported.
|
| qodana | 262.10968.76PhpStorm 262.10968.76 | 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 | Enforced | phpdoc_advanced_phpstan_consistent_constructor.php:39: Missing parent::__construct() call [parentConstructor]
|
| steins | 0.1.8steins 0.1.8 (2026-09-21 revision 76306a9) | Not enforced | No diagnostics reported.
|
| phpstan-strict | 2.3.1PHPStan - PHP Static Analysis Tool 2.3.1 | 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().
|
| psalm-next | 7.0.0-rc2Psalm 7.0.0-rc2@20339e3fe5b8d03bcd8061030eb2a83ad50e5783 | 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
{
}
}