← All results

false

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

The other constant boolean type, and the one PHP has always had a use for: it is the failure half of every string|false the standard library returns. Native since 8.2, like true. The probes are the opposite literal and a bool of unknown value. References: - PHPStan TypeNodeResolver false resolves to a constant boolean type

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 Partly enforced (1/2)
phpdoc_advanced_fallback_false.php:45: Argument 1 ($value) is true of type true but \Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse() takes false defined at /Users/megurine/repo/php/php-typing-conformance/conformance/tests/phpdoc_advanced_fallback_false.php:34 [PhanTypeMismatchArgument]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported
phpstan 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Enforced reported Lv.5+
phpdoc_advanced_fallback_false.php:45: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, true given. [identifier=argument.type] [reported-from-level=5]
phpdoc_advanced_fallback_false.php:50: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, bool given. [identifier=argument.type] [reported-from-level=5]
With strict-rules
phpdoc_advanced_fallback_false.php:45: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, true given. [identifier=argument.type]
phpdoc_advanced_fallback_false.php:50: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, bool 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_false.php:45: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, but true provided [InvalidArgument]
phpdoc_advanced_fallback_false.php:50: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, but bool provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
mago 1.46.0mago 1.46.0 Enforced
phpdoc_advanced_fallback_false.php:45: Invalid argument type for argument #1 of `Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse`: expected `false`, but found `true`. [invalid-argument]
phpdoc_advanced_fallback_false.php:50: Possible argument type mismatch for argument #1 of `Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse`: expected `false`, but possibly received `bool`. [possibly-invalid-argument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
mir 0.70.1mir 0.70.1 Partly enforced (1/2)
phpdoc_advanced_fallback_false.php:45: InvalidArgument: Argument $value of acceptsFalse() expects 'false', got 'true' [MIR0201]
  • Recognition: spelling resolved
  • Enforcement: 1/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 Widened to bool

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 Partly enforced (1/2)
phpdoc_advanced_fallback_false.php:45: Parameter 'true' type is not compatible with declaration [PhpParamsInspection]
  • Recognition: spelling resolved
  • Enforcement: 1/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 Enforced
phpdoc_advanced_fallback_false.php:45: potentially not safe access in parameter value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse [notSafeCall]
phpdoc_advanced_fallback_false.php:50: potentially not safe call in function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse signature of param value [notSafeCall]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported
steins 0.1.5steins 0.1.5 (2026-08-12 revision 39b4cc1) Partly enforced (1/2)
phpdoc_advanced_fallback_false.php:45: argument true to acceptsFalse() violates declared @param false $value — declared contract violation [phpdoc.param-mismatch]
  • Recognition: spelling resolved
  • Enforcement: 1/2 of the expected violations reported

Notes: The residual line (50: forwarding an unconstrained bool $value into the false-typed param) is correct zero-FP silence, not a gap — Base::Bool carries no refinement, so the fact is genuinely Maybe against LitBool(false) and steins-infer only reports on Certainty::No.

phpstan-strict 2.2.8PHPStan - PHP Static Analysis Tool 2.2.8 Enforced
phpdoc_advanced_fallback_false.php:45: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, true given. [identifier=argument.type]
phpdoc_advanced_fallback_false.php:50: Parameter #1 $value of function Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, bool 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_false.php:45: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, but true provided [InvalidArgument]
phpdoc_advanced_fallback_false.php:50: Argument 1 of Conformance\Tests\PhpdocAdvancedFallbackFalse\acceptsFalse expects false, but bool provided [InvalidArgument]
  • Recognition: spelling resolved
  • Enforcement: 2/2 of the expected violations reported

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\PhpdocAdvancedFallbackFalse;

/**
 * `false`
 *
 * The other constant boolean type, and the one PHP has always had a use for:
 * it is the failure half of every `string|false` the standard library returns.
 * Native since 8.2, like `true`. The probes are the opposite literal and a bool
 * of unknown value.
 *
 * References:
 * - PHPStan TypeNodeResolver `false` resolves to a constant boolean type
 */

/**
 * @return false
 */
function returnsFalse() // T: false
{
    return false; // V
}

function acceptsBool(bool $value): void
{
}

/**
 * @param false $value
 */
function acceptsFalse($value): void // T: false
{
}

// A `false` value always satisfies a native `bool` parameter.
acceptsBool(returnsFalse()); // V

// The literal satisfies the parameter.
acceptsFalse(false); // V

// The opposite literal does not.
acceptsFalse(true); // E?: true is not the literal type false

function forwardsRuntimeBool(bool $value): void
{
    // Neither does a bool whose value is not known.
    acceptsFalse($value); // E?: bool is wider than the literal type false
}