`@phpstan-var`

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

The prefixed form of @var, here on a property with no native type. Reading it is what gives the property a type at all, so a tool that ignores the prefix sees an untyped property rather than a wrongly typed one. References: - PHPStan phpdocs-basics: prefixed @phpstan-var - Psalm supported_annotations.md: @psalm-var

Analyzer results

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	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Argument 1 ($value) is new Holder()->value of type int but \Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString() takes string defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_vendor_prefixed_var_phpstan.php:31 [PhanTypeMismatchArgument] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
phpstan	2.2.11PHPStan - PHP Static Analysis Tool 2.2.11	Enforced reported Lv.5+	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString expects string, int given. [reported-from-level=5] With strict-rules phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString expects string, int given. Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm	6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac next: 7.0.0-beta19	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString expects string, but int provided [InvalidScalarArgument] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
mago	1.47.4mago 1.47.4	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Invalid argument type for argument #1 of `Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString`: expected `string`, but found `int`. [invalid-argument] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
mir	0.72.1mir 0.72.1	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: InvalidArgument: Argument $value of takesString() expects 'string', got 'int' [MIR0201] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
phpantom	0.10.0phpantom_lsp 0.10.0	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Argument 1 ($value) expects string, got int [type_mismatch_argument] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
intelephense	1.18.5intelephense 1.18.5	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Expected type 'string'. Found 'int'. [P1006] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
phpactor	2026.07.22.0Phpactor 2026.07.22.0	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpy	0.2.0phpy 0.2.0	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Argument '1' passed to Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString() is expected to be of type string, int given Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
qodana	262.9437.196Qodana 262.9437.196	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Parameter '(new Holder())->value' type is not compatible with declaration when using strict type matching [PhpParamsInspection] phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Parameter '(new Holder())->value' type is not compatible with declaration [PhpStrictTypeCheckingInspection] Recognition: spelling resolved Enforcement: 1/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_vendor_prefixed_var_phpstan.php:38: potentially not safe accessing property 'value' [notSafeCall] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
steins	0.1.6steins 0.1.6 (2026-08-25 revision c13b4c7)	Not enforced	No diagnostics reported. Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan-strict	2.2.11PHPStan - PHP Static Analysis Tool 2.2.11	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString expects string, int given. Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm-next	7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433	Enforced	phpdoc_advanced_vendor_prefixed_var_phpstan.php:38: Argument 1 of Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan\takesString expects string, but int provided [InvalidScalarArgument] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedVendorPrefixedVarPhpStan;

/**
 * Cross-tool handling of `@phpstan-var`
 *
 * The prefixed form of `@var`, here on a property with no native type. Reading
 * it is what gives the property a type at all, so a tool that ignores the
 * prefix sees an untyped property rather than a wrongly typed one.
 *
 * References:
 * - PHPStan phpdocs-basics: prefixed @phpstan-var
 * - Psalm supported_annotations.md: @psalm-var
 */

final class Holder
{
    /**
     * @phpstan-var int
     */
    public $value = 1; // T: @phpstan-var
}

function takesInt(int $value): void
{
}

function takesString(string $value): void
{
}

takesInt((new Holder())->value); // V

// The prefixed tag says the property is an int, which is not a string.
takesString((new Holder())->value); // E?: @phpstan-var int should be enforced where the property is read