Report editor-mode (--tmp-file) analysis under the --instead-of path so Scope::getFile() returns the real path

[phpstan-bot]

Summary

In editor mode (--tmp-file / --instead-of) PHPStan analysed the temp file under the temp file's own path, so Scope::getFile() returned the temp path (typically /tmp/xxxx.php) during Rule::processNode(). The path was only swapped back to the real file after analysis, when results were formatted. Any rule whose logic depends on the analysed file's location behaved differently in editor mode than in a normal run — e.g. Larastan's NoEnvCallsOutsideOfConfigRule fired on every env() call in config/*.php because the temp path never starts with <project>/config.

This change makes the analysis observe the file at its real (--instead-of) path: the temp file's content is still read/parsed/reflected, but the Scope, errors, collected data and line-ignores are all reported under the real path, so Scope::getFile() (and anything derived from it) matches a normal analysis run.

Changes

• src/Analyser/ScopeContext.php — carries both file (reported path) and analysisFile (temp file being read); adds getAnalysisFile(). create() gains an optional second argument (backward compatible).
• src/Analyser/FileAnalyser.php — analyseFile() gains a ?string $reportedFile argument. The temp file is parsed/read, but the ScopeContext, FileAnalyserCallback, processed-files list and parse/reflection error paths are reported under $reportedFile.
• src/Analyser/Analyser.php / src/Command/AnalyserRunner.php / src/Parallel/WorkerRunner.php — thread --tmp-file / --instead-of through so both the single-process and parallel worker paths report the real path.
• src/Analyser/EditorModeFileHelper.php (new) — maps a reported path back to the temp file whose content is analysed (identity outside editor mode).
• src/Analyser/MutatingScope.php — getAnalysisFile(); __COMPILER_HALT_OFFSET__ detection parses the analysis file.
• src/Analyser/NodeScopeResolver.php — AST-based class reflection (getCurrentClassReflection / createAstClassReflection) matches and reads the analysis file.
• src/Reflection/BetterReflection/BetterReflectionProvider.php — anonymous-class reflection reads/identifies via the analysis file.
• src/Type/FileTypeMapper.php — getResolvedPhpDoc() / getNameScope() resolve the PHPDoc name-scope from the analysis file, so PHPDoc rules (including third-party ones) that pass Scope::getFile() still read the edited use/namespace context.
• src/Analyser/ResultCache/ResultCacheManager.php — merging of errors, locally-ignored errors and collected data no longer remaps the cache key through fileReplacements (these fresh results are now keyed by the real path). File-hash and exported-node reads still resolve to the temp file so cache invalidation stays correct.

Root cause

The file identity used during analysis was the temp file, with a post-analysis path swap normalizing the output. Rules run before that swap, so they saw the temp path. The fix inverts this for everything rules observe: the real path becomes the identity for the Scope, errors, collected data and line-ignores, while a single helper (EditorModeFileHelper) redirects the handful of internal consumers that genuinely need the temp file's content — reflection matching/reading (NodeScopeResolver, BetterReflectionProvider), PHPDoc name-scope resolution (FileTypeMapper) and the __halt_compiler check (MutatingScope). The temp file stays the cache identity for reflection/PHPDoc so persistent caches are not poisoned across runs.

Analogous location-derived behaviors fixed by the same change (each now matching a normal run instead of leaking the temp path): Scope::getFileDescription(), RequireFileExistsRule (dirname($scope->getFile())), and the __FILE__ / __DIR__ magic constants (InitializerExprContext).

Test

• tests/PHPStan/Analyser/EditorModeGetFileTest.php — runs FileAnalyser::analyseFile() on a temp file with a reportedFile, asserting a rule sees the real path via both Scope::getFile() and Scope::getFileDescription(), and that the reported error path is the real path; a second case confirms non-editor-mode behavior is unchanged. Verified failing before the fix (reported the temp path) and passing after.
• The existing e2e/editor-mode scenario (reflection of the edited file across a dependency, plus the result-cache restore path) continues to pass, including the assertion that the temp path never appears in output.

Fixes phpstan/phpstan#14982

[ondrejmirtes]

This looks very complicated, let it settle for a while.