`@psalm-consistent-constructor`

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

Psalm's spelling of the same idea as @phpstan-consistent-constructor: children must keep a compatible constructor so new static() is safe. References: - Psalm supported_annotations.md: @psalm-consistent-constructor - PHPStan phpdocs-basics: Consistent constructor

Analyzer results

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. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan	2.3.1PHPStan - PHP Static Analysis Tool 2.3.1	Enforced reported Lv.0+	phpdoc_advanced_psalm_consistent_constructor.php:38: Parameter #1 $id (int) of method Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct() is not contravariant with parameter #1 $name (string) of method Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct(). [reported-from-level=0] With strict-rules phpdoc_advanced_psalm_consistent_constructor.php:38: Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor. phpdoc_advanced_psalm_consistent_constructor.php:38: Parameter #1 $id (int) of method Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct() is not contravariant with parameter #1 $name (string) of method Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct(). Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm	6.20.0Psalm 6.20.0@804f03c0c183d149fcd4b8c7c0c9b3fbf836d34c next: 7.0.0-rc2	Enforced	phpdoc_advanced_psalm_consistent_constructor.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct has wrong name $id, expecting $name as defined by Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct [ParamNameMismatch] phpdoc_advanced_psalm_consistent_constructor.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct has wrong type 'int', expecting 'string' as defined by Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct [ConstructorSignatureMismatch] phpdoc_advanced_psalm_consistent_constructor.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct has wrong type 'int', expecting 'string' as defined by Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct [ImplementedParamTypeMismatch] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
mago	1.57.0mago 1.57.0	Enforced	phpdoc_advanced_psalm_consistent_constructor.php:38: Parameter `$id` of `Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct()` expects type `int` but parent `Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct()` expects type `string` [incompatible-parameter-type] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
mir	0.87.0mir 0.87.0	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpantom	0.11.1phpantom_lsp 0.11.1	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.10.07.0Phpactor 2026.10.07.0	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpy	1.0.19409phpy 1.0.19409	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
qodana	262.10968.76PhpStorm 262.10968.76	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_psalm_consistent_constructor.php:38: Missing parent::__construct() call [parentConstructor] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
steins	0.1.8steins 0.1.8 (2026-09-21 revision 76306a9)	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan-strict	2.3.1PHPStan - PHP Static Analysis Tool 2.3.1	Enforced	phpdoc_advanced_psalm_consistent_constructor.php:38: Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct() does not call parent constructor from Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor. phpdoc_advanced_psalm_consistent_constructor.php:38: Parameter #1 $id (int) of method Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct() is not contravariant with parameter #1 $name (string) of method Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct(). Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm-next	7.0.0-rc2Psalm 7.0.0-rc2@20339e3fe5b8d03bcd8061030eb2a83ad50e5783	Enforced	phpdoc_advanced_psalm_consistent_constructor.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct has wrong name $id, expecting $name as defined by Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct [ParamNameMismatch] phpdoc_advanced_psalm_consistent_constructor.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct has wrong type 'int', expecting 'string' as defined by Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct [ConstructorSignatureMismatch] phpdoc_advanced_psalm_consistent_constructor.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ChildWithDifferentCtor::__construct has wrong type 'int', expecting 'string' as defined by Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor\ParentWithCtor::__construct [ImplementedParamTypeMismatch] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedPsalmConsistentConstructor;

/**
 * Cross-tool handling of `@psalm-consistent-constructor`.
 *
 * Psalm's spelling of the same idea as `@phpstan-consistent-constructor`:
 * children must keep a compatible constructor so `new static()` is safe.
 *
 * References:
 * - Psalm supported_annotations.md: `@psalm-consistent-constructor`
 * - PHPStan phpdocs-basics: Consistent constructor
 */

/**
 * @psalm-consistent-constructor
 */
class ParentWithCtor // T: @psalm-consistent-constructor
{
    public function __construct(string $name)
    {
        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
{
}

final class ChildWithDifferentCtor extends ParentWithCtor
{
    public function __construct(int $id) // E?: not compatible under @psalm-consistent-constructor
    {
        if ($id < 0) {
            throw new \InvalidArgumentException('negative id');
        }
    }
}