← All results

Mir's bare @trace diagnostic (MIR0221)

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

This is mir's native spelling (not a Psalm short form — Psalm only documents @psalm-trace; see debug_psalm_trace). Mago accepts bare @trace as a compatibility alias; pzoom (Psalm port) may as well. Mir emits an info-level Trace issue; the suite enables --show-info only for debug_* files so other tests stay quiet. Critical layout: the @trace docblock line must have **no** trailing // comments, or mir drops the annotation. Attribution varies — Mago often blames the enclosing if, mir/pzoom the next statement — so both share one optional probe group. References: - mir site: Trace / MIR0221 - mir CHANGELOG: @trace docblock annotation

Analyzer results

AnalyzerVersionResultDiagnostics
phan 6.0.10Phan 6.0.10 php-ast version 1.1.3 PHP version used to run Phan: 8.5.11 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpstan 2.3.1PHPStan - PHP Static Analysis Tool 2.3.1 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
psalm 6.20.0Psalm 6.20.0@804f03c0c183d149fcd4b8c7c0c9b3fbf836d34c
next: 7.0.0-rc2		 Not enforced (pzoom≠)
pzoom (Psalm port)
debug_mir_trace.php:33: $value: int [Trace]
  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
mago 1.57.0mago 1.57.0 Enforced 
debug_mir_trace.php:32: Trace: Type of `$value` is `int` [psalm-trace]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
mir 0.87.0mir 0.87.0 Enforced 
debug_mir_trace.php:33: Trace: Type of $value is int [MIR0221]
  • Recognition: spelling resolved
  • Enforcement: 1/1 of the expected violations reported
phpantom 0.11.1phpantom_lsp 0.11.1 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
intelephense 1.18.5intelephense 1.18.5 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpactor 2026.10.07.0Phpactor 2026.10.07.0 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpy 1.0.19409phpy 1.0.19409 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
qodana 262.10968.76PhpStorm 262.10968.76 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

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
steins 0.1.8steins 0.1.8 (2026-09-21 revision 76306a9) Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
phpstan-strict 2.3.1PHPStan - PHP Static Analysis Tool 2.3.1 Not enforced

No diagnostics reported.

  • Recognition: spelling resolved
  • Enforcement: 0/1 of the expected violations reported
psalm-next 7.0.0-rc2Psalm 7.0.0-rc2@20339e3fe5b8d03bcd8061030eb2a83ad50e5783 Not enforced

No diagnostics reported.

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

Source

<?php

declare(strict_types=1);

namespace Conformance\Tests\DebugMirTrace;

/**
 * Cross-tool handling of mir's bare `@trace` diagnostic (MIR0221).
 *
 * This is mir's native spelling (not a Psalm short form — Psalm only
 * documents `@psalm-trace`; see `debug_psalm_trace`). Mago accepts bare
 * `@trace` as a compatibility alias; pzoom (Psalm port) may as well.
 *
 * Mir emits an info-level Trace issue; the suite enables `--show-info` only
 * for `debug_*` files so other tests stay quiet.
 *
 * Critical layout: the `@trace` docblock line must have **no** trailing `//`
 * comments, or mir drops the annotation. Attribution varies — Mago often
 * blames the enclosing `if`, mir/pzoom the next statement — so both share
 * one optional probe group.
 *
 * References:
 * - mir site: Trace / MIR0221
 * - mir CHANGELOG: `@trace` docblock annotation
 *
 * @conformance-kind debug
 */

function example(int|string $value): void // T: @trace
{
    if (\is_int($value)) { // E?[trace]: Mago may attribute the enclosing statement
        /** @trace $value */
        echo $value; // E?[trace]: mir / pzoom attribute the next statement
    }
}