← All results

@phan-read-only and @phan-write-only

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

Phan-specific property access polarity: read-only forbids external writes; write-only forbids reads. References: - Phan Annotating-Your-Source-Code: @phan-read-only and @phan-write-only

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 Enforced 
phpdoc_advanced_phan_read_only_write_only.php:28: Cannot modify read-only property \Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly\Bag->id defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_phan_read_only_write_only.php:20 [PhanAccessReadOnlyProperty]
phpdoc_advanced_phan_read_only_write_only.php:31: Cannot read write-only property \Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly\Bag->scratch defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_phan_read_only_write_only.php:23 [PhanAccessWriteOnlyProperty]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
phpstan 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Unrecognized reported Lv.3+ 
phpdoc_advanced_phan_read_only_write_only.php:20: @readonly property cannot have a default value. [identifier=property.readOnlyByPhpDocDefaultValue] [reported-from-level=0]
phpdoc_advanced_phan_read_only_write_only.php:28: @readonly property Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly\Bag::$id is assigned outside of its declaring class. [identifier=property.readOnlyByPhpDocAssignOutOfClass] [reported-from-level=3]
With strict-rules
phpdoc_advanced_phan_read_only_write_only.php:20: @readonly property cannot have a default value. [identifier=property.readOnlyByPhpDocDefaultValue]
phpdoc_advanced_phan_read_only_write_only.php:28: @readonly property Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly\Bag::$id is assigned outside of its declaring class. [identifier=property.readOnlyByPhpDocAssignOutOfClass]
  • Recognition: spelling not resolved — reported on declaration line(s) 20
  • Enforcement: 1/2 of the expected violations reported — incidental, since the spelling was not resolved
psalm 6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac
next: 7.0.0-beta19		 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
mago 1.46.0mago 1.46.0 Partly enforced (1/2) 
phpdoc_advanced_phan_read_only_write_only.php:28: Cannot write to protected property `$id` on class `Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly\Bag`. [invalid-property-write]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
mir 0.70.1mir 0.70.1 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
phpantom 0.9.0phpantom_lsp 0.9.0 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
phpy 0.2.0phpy 0.2.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
qodana 262.8665.325Qodana 262.8665.325 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.5steins 0.1.5 (2026-08-12 revision 39b4cc1) Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/2 of the expected violations reported
phpstan-strict 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Unrecognized 
phpdoc_advanced_phan_read_only_write_only.php:20: @readonly property cannot have a default value. [identifier=property.readOnlyByPhpDocDefaultValue]
phpdoc_advanced_phan_read_only_write_only.php:28: @readonly property Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly\Bag::$id is assigned outside of its declaring class. [identifier=property.readOnlyByPhpDocAssignOutOfClass]
  • Recognition: spelling not resolved — reported on declaration line(s) 20
  • Enforcement: 1/2 of the expected violations reported — incidental, since the spelling was not resolved
psalm-next 7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433 Not enforced

No diagnostics reported.

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

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedPhanReadOnlyWriteOnly;

/**
 * Cross-tool handling of `@phan-read-only` and `@phan-write-only`.
 *
 * Phan-specific property access polarity: read-only forbids external writes;
 * write-only forbids reads.
 *
 * References:
 * - Phan Annotating-Your-Source-Code: `@phan-read-only` and `@phan-write-only`
 */

final class Bag
{
    /** @phan-read-only */
    public int $id = 1; // T: @phan-read-only

    /** @phan-write-only */
    public int $scratch = 0; // T: @phan-write-only
}

$bag = new Bag();
echo $bag->id; // V
$bag->id = 2; // E?: @phan-read-only property written

$bag->scratch = 3; // V
echo $bag->scratch; // E?: @phan-write-only property read