← All results

Negated assertion form @phpstan-assert !Type

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

The PHPStan spelling of the same subtraction operator documented for Psalm. A tool that honours one vendor's ! and not the other is choosing which dialect to read. References: - PHPStan narrowing-types.md: Type negation (@phpstan-assert !string) - Psalm assertion_syntax.md: Negated assertions

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 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpstan 2.2.11PHPStan - PHP Static Analysis Tool 2.2.11 Enforced reported Lv.4+
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Call to function is_int() with string will always evaluate to false. [reported-from-level=4]
With strict-rules
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Call to function is_int() with string will always evaluate to false.
  • 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 (pzoom≠)
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Type string for $value is never int [TypeDoesNotContainType]
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Type string for $value is never int [RedundantCondition]
pzoom (Psalm port)

No diagnostics from pzoom.

  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
mago 1.47.4mago 1.47.4 Enforced
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Impossible type assertion: `$value` of type `string` can never be `int`. [impossible-type-comparison]
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Redundant ternary operator: condition is always falsy. [impossible-condition]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
mir 0.72.1mir 0.72.1 Not enforced
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:37: PossiblyInvalidArgument: Argument $value of takesString() expects 'string', possibly different type 'int|string' provided [MIR0105]
  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
Expectation diff
Line 37: Expected valid value to be accepted, got ["PossiblyInvalidArgument: Argument $value of takesString() expects 'string', possibly different type 'int|string' provided [MIR0105]"]
phpantom 0.10.0phpantom_lsp 0.10.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
intelephense 1.18.5intelephense 1.18.5 Incidental (0/1)
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:37: Expected type 'string'. Found 'int|string'. [P1006]
  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported — incidental, since values the type admits were also rejected on line(s) 37
Expectation diff
Line 37: Expected valid value to be accepted, got ["Expected type 'string'. Found 'int|string'. [P1006]"]
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 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
qodana 262.9437.196Qodana 262.9437.196 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 Not enforced
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:37: potentially not safe call in function Conformance\Tests\PhpdocAdvancedVendorPrefixedAssertNegatedPhpStan\takesString signature of param value [notSafeCall]
  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
Expectation diff
Line 37: Expected valid value to be accepted, got ["potentially not safe call in function Conformance\\Tests\\PhpdocAdvancedVendorPrefixedAssertNegatedPhpStan\\takesString signature of param value [notSafeCall]"]
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_assert_negated_phpstan.php:43: Call to function is_int() with string will always evaluate to false.
  • 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_assert_negated_phpstan.php:43: Type string for $value is never int [TypeDoesNotContainType]
phpdoc_advanced_vendor_prefixed_assert_negated_phpstan.php:43: Type string for $value is never int [RedundantCondition]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedVendorPrefixedAssertNegatedPhpStan;

/**
 * Negated assertion form `@phpstan-assert !Type`.
 *
 * The PHPStan spelling of the same subtraction operator documented for
 * Psalm. A tool that honours one vendor's `!` and not the other is choosing
 * which dialect to read.
 *
 * References:
 * - PHPStan narrowing-types.md: Type negation (`@phpstan-assert !string`)
 * - Psalm assertion_syntax.md: Negated assertions
 */

/**
 * @phpstan-assert !int $value
 */
function assertNotInt(int|string $value): void // T: @phpstan-assert !int
{
    if (\is_int($value)) {
        throw new \InvalidArgumentException('must not be int');
    }
}

function takesString(string $value): void
{
}

function example(int|string $value): void
{
    assertNotInt($value);

    takesString($value); // V

    // After subtracting int, only string remains, so an is_int() check is
    // provably dead. A tool that ignores the tag (or parses `!int` as an
    // unknown type) leaves the union intact, where is_int() is a live check
    // and nothing is reported — so the diagnostic marks real enforcement.
    echo \is_int($value) ? 'int' : 'string'; // E?: after @phpstan-assert !int, is_int() is always false
}