← All results

callable-string

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

A string that names something callable, so the refinement is only meaningful for an analyzer that knows which function names exist. Analyzers that model it reject a name nothing is declared under; others fall back to plain string and accept it. References: - PHPStan TypeNodeResolver callable-string resolves to string&CallableType

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_fallback_callable_string.php:45: Call to undeclared function definitely_not_a_function in callable [PhanUndeclaredFunctionInCallable]
phpdoc_advanced_fallback_callable_string.php:48: Call to undeclared function stdClass in callable [PhanUndeclaredFunctionInCallable]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
phpstan 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Enforced reported Lv.5+
phpdoc_advanced_fallback_callable_string.php:45: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, 'definitely_not_a…' given. [identifier=argument.type] [reported-from-level=5]
phpdoc_advanced_fallback_callable_string.php:48: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, 'stdClass' given. [identifier=argument.type] [reported-from-level=5]
With strict-rules
phpdoc_advanced_fallback_callable_string.php:45: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, 'definitely_not_a…' given. [identifier=argument.type]
phpdoc_advanced_fallback_callable_string.php:48: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, 'stdClass' given. [identifier=argument.type]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
psalm 6.16.1Psalm 6.16.1@f1f5de594dc76faf8784e02d3dc4716c91c6f6ac
next: 7.0.0-beta19
Enforced
phpdoc_advanced_fallback_callable_string.php:45: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, but 'definitely_not_a_function' provided [InvalidArgument]
phpdoc_advanced_fallback_callable_string.php:48: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, but stdClass::class provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
mago 1.46.0mago 1.46.0 Partly enforced (1/2)
phpdoc_advanced_fallback_callable_string.php:45: Possible argument type mismatch for argument #1 of `Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString`: expected `callable-string`, but possibly received `string('definitely_not_a_function')`. [possibly-invalid-argument]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
mir 0.70.1mir 0.70.1 Enforced
phpdoc_advanced_fallback_callable_string.php:45: UndefinedFunction: Function definitely_not_a_function() is not defined [MIR0003]
phpdoc_advanced_fallback_callable_string.php:48: InvalidArgument: Argument $value of acceptsCallableString() expects 'callable-string', got 'class-string<stdClass>' [MIR0201]
  • Recognition: spelling resolved
  • Enforcement: 2/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) Widened to string

No diagnostics reported.

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

Notes: `callable-string` lowers to `ContractTy::StrOpaque` (ADR-0038), so Steins never checks that the string names an existing function or method — it accepts any string.

phpstan-strict 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Enforced
phpdoc_advanced_fallback_callable_string.php:45: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, 'definitely_not_a…' given. [identifier=argument.type]
phpdoc_advanced_fallback_callable_string.php:48: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, 'stdClass' given. [identifier=argument.type]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
psalm-next 7.0.0-beta19Psalm 7.0.0-beta19@7e751c06a756fa64dc4c759c09fe4a173afcb433 Enforced
phpdoc_advanced_fallback_callable_string.php:45: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, but 'definitely_not_a_function' provided [InvalidArgument]
phpdoc_advanced_fallback_callable_string.php:48: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackCallableString\acceptsCallableString expects callable-string, but stdClass::class provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedFallbackCallableString;

/**
 * `callable-string`
 *
 * A string that names something callable, so the refinement is only meaningful
 * for an analyzer that knows which function names exist. Analyzers that model
 * it reject a name nothing is declared under; others fall back to plain
 * `string` and accept it.
 *
 * References:
 * - PHPStan TypeNodeResolver `callable-string` resolves to string&CallableType
 */

/**
 * @return callable-string
 */
function returnsCallableString() // T: callable-string
{
    return 'strlen'; // V
}

function acceptsString(string $value): void
{
}

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

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

// The name of an existing function satisfies the parameter.
acceptsCallableString('strlen'); // V

// A name nothing is declared under does not.
acceptsCallableString('definitely_not_a_function'); // E?: an undeclared name is not a callable-string

// Neither does the name of a class, which is a string PHP will not call.
acceptsCallableString(\stdClass::class); // E?: a class-string is not a callable-string