← All results

@psalm-immutable

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

Class-level immutability: public properties behave as readonly for consumers and non-constructor methods must not mutate $this. References: - Psalm supported_annotations.md: @psalm-immutable

Analyzer results

AnalyzerVersionResultDiagnostics
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/2 of the expected violations reported
phpstan 2.3.1PHPStan - PHP Static Analysis Tool 2.3.1 Enforced reported Lv.3+
phpdoc_advanced_psalm_immutable.php:29: @readonly property Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is assigned outside of the constructor. [reported-from-level=3]
phpdoc_advanced_psalm_immutable.php:35: @readonly property Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is assigned outside of its declaring class. [reported-from-level=3]
With strict-rules
phpdoc_advanced_psalm_immutable.php:29: @readonly property Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is assigned outside of the constructor.
phpdoc_advanced_psalm_immutable.php:35: @readonly property Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is assigned outside of its declaring class.
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
psalm 6.20.0Psalm 6.20.0@804f03c0c183d149fcd4b8c7c0c9b3fbf836d34c
next: 7.0.0-rc2
Enforced
phpdoc_advanced_psalm_immutable.php:29: Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is marked readonly [InaccessibleProperty]
phpdoc_advanced_psalm_immutable.php:35: Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is marked readonly [InaccessibleProperty]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
mago 1.57.0mago 1.57.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
mir 0.87.0mir 0.87.0 Enforced
phpdoc_advanced_psalm_immutable.php:29: ImmutablePropertyModification: Assigning to property label of $this in an immutable context (@psalm-immutable class or @psalm-mutation-free method) [MIR1705]
phpdoc_advanced_psalm_immutable.php:35: ImmutablePropertyModification: Assigning to property label of $point in an immutable context (@psalm-immutable class or @psalm-mutation-free method) [MIR1705]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
phpantom 0.11.1phpantom_lsp 0.11.1 Not enforced

No diagnostics reported.

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

No diagnostics reported.

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

No diagnostics reported.

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

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
qodana 262.10968.76PhpStorm 262.10968.76 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 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 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 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/2 of the expected violations reported
phpstan-strict 2.3.1PHPStan - PHP Static Analysis Tool 2.3.1 Enforced
phpdoc_advanced_psalm_immutable.php:29: @readonly property Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is assigned outside of the constructor.
phpdoc_advanced_psalm_immutable.php:35: @readonly property Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is assigned outside of its declaring class.
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
psalm-next 7.0.0-rc2Psalm 7.0.0-rc2@20339e3fe5b8d03bcd8061030eb2a83ad50e5783 Enforced
phpdoc_advanced_psalm_immutable.php:29: Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is marked readonly [InaccessibleProperty]
phpdoc_advanced_psalm_immutable.php:29: The context is read-props but property assignment to Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label requires write-this-props [ImpurePropertyAssignment]
phpdoc_advanced_psalm_immutable.php:35: Conformance\Tests\PhpdocAdvancedPsalmImmutable\Point::$label is marked readonly [InaccessibleProperty]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedPsalmImmutable;

/**
 * Cross-tool handling of `@psalm-immutable`.
 *
 * Class-level immutability: public properties behave as readonly for consumers
 * and non-constructor methods must not mutate `$this`.
 *
 * References:
 * - Psalm supported_annotations.md: `@psalm-immutable`
 */

/**
 * @psalm-immutable
 */
final class Point // T: @psalm-immutable
{
    public function __construct(
        public string $label,
    ) {
    }

    public function relabel(string $label): void
    {
        $this->label = $label; // E?: mutation inside immutable class method
    }
}

$point = new Point('origin'); // V
echo $point->label; // V
$point->label = 'moved'; // E?: immutable property assigned outside constructor