← All results

numeric-string

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

numeric-string is a refinement of string, so a @return numeric-string value always satisfies a native string parameter — analyzers that do not model it still fall back to string. Analyzers that enforce the refinement additionally reject a literal that is not numeric. References: - PHPStan TypeNodeResolver numeric-string resolves to string&AccessoryNumericString

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 Unrecognized 
phpdoc_advanced_fallback_numeric_string.php:32: Saw possibly unextractable annotation for a fragment of comment '* @param numeric-string $value': after numeric, did not see an element name (will guess based on comment order) [PhanUnextractableAnnotationElementName]
phpdoc_advanced_fallback_numeric_string.php:32: Saw a token Phan may have failed to parse after '* @param numeric-string $value': after numeric, saw '-' [PhanUnextractableAnnotationSuffix]
phpdoc_advanced_fallback_numeric_string.php:34: Parameter $value has undeclared type \Conformance\Tests\PhpdocAdvancedFallbackNumericString\numeric [PhanUndeclaredTypeParameter]
phpdoc_advanced_fallback_numeric_string.php:42: Argument 1 ($value) is '123' of type string but \Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString() takes \Conformance\Tests\PhpdocAdvancedFallbackNumericString\numeric (no real type) defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_fallback_numeric_string.php:34 (the inferred real argument type has nothing in common with the parameter's phpdoc type) [PhanTypeMismatchArgumentProbablyReal]
phpdoc_advanced_fallback_numeric_string.php:46: Argument 1 ($value) is 'not numeric' of type string but \Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString() takes \Conformance\Tests\PhpdocAdvancedFallbackNumericString\numeric (no real type) defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_fallback_numeric_string.php:34 (the inferred real argument type has nothing in common with the parameter's phpdoc type) [PhanTypeMismatchArgumentProbablyReal]
  • Recognition: spelling not resolved — reported on declaration line(s) 32, 34
  • Enforcement: 1/1 of the expected violations reported — incidental, since the spelling was not resolved
Expectation diff
Line 42: Expected valid value to be accepted, got ["Argument 1 ($value) is '123' of type string but \\Conformance\\Tests\\PhpdocAdvancedFallbackNumericString\\acceptsNumericString() takes \\Conformance\\Tests\\PhpdocAdvancedFallbackNumericString\\numeric (no real type) defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_fallback_numeric_string.php:34 (the inferred real argument type has nothing in common with the parameter's phpdoc type) [PhanTypeMismatchArgumentProbablyReal]"]

Notes: Phan cannot parse the hyphenated `numeric-string` pseudo-type and reports an annotation-extraction error instead of checking the argument.

phpstan 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Enforced reported Lv.5+ 
phpdoc_advanced_fallback_numeric_string.php:46: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString expects numeric-string, 'not numeric' given. [identifier=argument.type] [reported-from-level=5]
With strict-rules
phpdoc_advanced_fallback_numeric_string.php:46: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString expects numeric-string, 'not numeric' given. [identifier=argument.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		 Enforced 
phpdoc_advanced_fallback_numeric_string.php:46: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString expects numeric-string, but 'not numeric' provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
mago 1.46.0mago 1.46.0 Enforced 
phpdoc_advanced_fallback_numeric_string.php:46: Possible argument type mismatch for argument #1 of `Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString`: expected `numeric-string`, but possibly received `string('not numeric')`. [possibly-invalid-argument]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
mir 0.70.1mir 0.70.1 Enforced 
phpdoc_advanced_fallback_numeric_string.php:46: InvalidArgument: Argument $value of acceptsNumericString() expects 'numeric-string', got '"not numeric"' [MIR0201]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
phpantom 0.9.0phpantom_lsp 0.9.0 Enforced 
phpdoc_advanced_fallback_numeric_string.php:46: Argument 1 ($value) expects numeric-string, got 'not numeric' [type_mismatch_argument]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
intelephense 1.18.5intelephense 1.18.5 Widened to string

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.8665.325Qodana 262.8665.325 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 Widened to string

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
steins 0.1.5steins 0.1.5 (2026-08-12 revision 39b4cc1) Enforced 
phpdoc_advanced_fallback_numeric_string.php:46: argument "not numeric" to acceptsNumericString() violates declared @param numeric-string $value — declared contract violation [phpdoc.param-mismatch]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
phpstan-strict 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Enforced 
phpdoc_advanced_fallback_numeric_string.php:46: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString expects numeric-string, 'not numeric' given. [identifier=argument.type]
  • 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_fallback_numeric_string.php:46: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackNumericString\acceptsNumericString expects numeric-string, but 'not numeric' provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedFallbackNumericString;

/**
 * `numeric-string`
 *
 * `numeric-string` is a refinement of `string`, so a `@return numeric-string`
 * value always satisfies a native `string` parameter — analyzers that do not
 * model it still fall back to `string`. Analyzers that enforce the refinement
 * additionally reject a literal that is not numeric.
 *
 * References:
 * - PHPStan TypeNodeResolver `numeric-string` resolves to string&AccessoryNumericString
 */

/**
 * @return numeric-string
 */
function returnsNumericString() // T: numeric-string
{
    return '123'; // V
}

function acceptsString(string $value): void
{
}

/**
 * @param numeric-string $value
 */
function acceptsNumericString($value): void // T: numeric-string
{
}

// A `numeric-string` value always satisfies a native `string` parameter.
acceptsString(returnsNumericString()); // V

// A literal numeric string satisfies the refined parameter.
acceptsNumericString('123'); // V

// A non-numeric literal: enforcing analyzers reject it, others fall back to
// `string` and accept it.
acceptsNumericString('not numeric'); // E?: non-numeric string should be rejected where numeric-string is required