`PHPStan\Testing\assertType()`

Group: Debug features · Category: extension · File: debug_phpstan_assert_type.php

Fixture-style assertion: the first argument is the expected type string. When the actual type disagrees, PHPStan reports a type assertion failure. Correct assertions are silent — that silence is success, not a miss, so only the *mismatch* line is an enforcement probe. References: - PHPStan Testing helpers: PHPStan\Testing\assertType

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	Not enforced	debug_phpstan_assert_type.php:24: Call to undeclared function \PHPStan\Testing\assertType() [PhanUndeclaredFunction] debug_phpstan_assert_type.php:27: Call to undeclared function \PHPStan\Testing\assertType() [PhanUndeclaredFunction] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan	2.2.8PHPStan - PHP Static Analysis Tool 2.2.8	Enforced reported Lv.0+	debug_phpstan_assert_type.php:27: Expected type string, actual: int [identifier=phpstan.type] [reported-from-level=0] With strict-rules debug_phpstan_assert_type.php:27: Expected type string, actual: int [identifier=phpstan.type] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm	6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac next: 7.0.0-beta19	Not enforced	debug_phpstan_assert_type.php:24: Function PHPStan\Testing\assertType does not exist, consider enabling the allFunctionsGlobal config option if scanning legacy codebases [UndefinedFunction] debug_phpstan_assert_type.php:27: Function PHPStan\Testing\assertType does not exist, consider enabling the allFunctionsGlobal config option if scanning legacy codebases [UndefinedFunction] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
mago	1.46.0mago 1.46.0	Not enforced	debug_phpstan_assert_type.php:24: Function `PHPStan\Testing\assertType` could not be found. [non-existent-function] debug_phpstan_assert_type.php:27: Function `PHPStan\Testing\assertType` could not be found. [non-existent-function] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
mir	0.70.1mir 0.70.1	Not enforced	debug_phpstan_assert_type.php:24: UndefinedFunction: Function PHPStan\Testing\assertType() is not defined [MIR0003] debug_phpstan_assert_type.php:27: UndefinedFunction: Function PHPStan\Testing\assertType() is not defined [MIR0003] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpantom	0.9.0phpantom_lsp 0.9.0	Not enforced	debug_phpstan_assert_type.php:24: Function 'PHPStan\Testing\assertType' not found [unknown_function] debug_phpstan_assert_type.php:27: Function 'PHPStan\Testing\assertType' not found [unknown_function] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
intelephense	1.18.5intelephense 1.18.5	Not enforced	debug_phpstan_assert_type.php:24: Undefined function 'PHPStan\Testing\assertType'. [P1010] debug_phpstan_assert_type.php:27: Undefined function 'PHPStan\Testing\assertType'. [P1010] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpy	0.2.0phpy 0.2.0	Not enforced	debug_phpstan_assert_type.php:24: Call to unknown function: 'PHPStan\Testing\assertType' debug_phpstan_assert_type.php:27: Call to unknown function: 'PHPStan\Testing\assertType' Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
qodana	262.8665.325Qodana 262.8665.325	Not enforced	debug_phpstan_assert_type.php:24: Undefined namespace 'Testing' [PhpUndefinedNamespaceInspection] debug_phpstan_assert_type.php:27: Undefined namespace 'Testing' [PhpUndefinedNamespaceInspection] 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	debug_phpstan_assert_type.php:24: Call to undefined function \PHPStan\Testing\assertType [undefinedFunction] debug_phpstan_assert_type.php:27: Call to undefined function \PHPStan\Testing\assertType [undefinedFunction] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
steins	0.1.5steins 0.1.5 (2026-08-12 revision 39b4cc1)	Not enforced	debug_phpstan_assert_type.php:24: call to undefined function PHPStan\Testing\assertType() — not defined in the project, not on PHP 8.5.9 (70 extensions) [call.undefined-function] debug_phpstan_assert_type.php:27: call to undefined function PHPStan\Testing\assertType() — not defined in the project, not on PHP 8.5.9 (70 extensions) [call.undefined-function] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported
phpstan-strict	2.2.8PHPStan - PHP Static Analysis Tool 2.2.8	Enforced	debug_phpstan_assert_type.php:27: Expected type string, actual: int [identifier=phpstan.type] Recognition: spelling resolved Enforcement: 1/1 of the expected violations reported
psalm-next	7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433	Not enforced	debug_phpstan_assert_type.php:24: Function PHPStan\Testing\assertType does not exist, consider enabling the allFunctionsGlobal config option if scanning legacy codebases [UndefinedFunction] debug_phpstan_assert_type.php:27: Function PHPStan\Testing\assertType does not exist, consider enabling the allFunctionsGlobal config option if scanning legacy codebases [UndefinedFunction] Recognition: spelling resolved Enforcement: 0/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\DebugPhpstanAssertType;

/**
 * Cross-tool handling of `PHPStan\Testing\assertType()`.
 *
 * Fixture-style assertion: the first argument is the expected type string.
 * When the actual type disagrees, PHPStan reports a type assertion failure.
 * Correct assertions are silent — that silence is success, not a miss, so
 * only the *mismatch* line is an enforcement probe.
 *
 * References:
 * - PHPStan Testing helpers: `PHPStan\Testing\assertType`
 *
 * @conformance-kind debug
 */

function example(int $value): void // T: PHPStan\Testing\assertType
{
    // Correct: silence when honoured. Foreign undefined-function is noise only.
    \PHPStan\Testing\assertType('int', $value); // E?[noise]

    // Wrong expected type: the sole enforcement probe.
    \PHPStan\Testing\assertType('string', $value); // E?: Expected type string, actual: int
}