PHPStan路径匹配失效问题分析与解决方案

问题背景

在使用PHPStan进行代码静态分析时，开发者发现基于路径的规则配置无法正常工作。具体表现为：

1. 路径排除规则（excludePaths）失效
2. 基于路径的错误忽略规则（ignoreErrors.paths）不生效

根本原因

经过深入分析，发现问题源于PHPStan分析器的实现机制。当通过语言服务器进行实时分析时，PHPStan会将当前编辑的文件内容写入临时文件进行分析，而非直接分析原始文件。这导致两个关键影响：

1. 路径上下文丢失 - 临时文件路径与原始项目路径结构完全不同
2. 路径匹配失效 - 所有基于项目路径的配置规则都无法匹配临时文件路径

技术验证

开发者通过以下方式验证了这一假设：

1. 修改临时文件路径配置，发现路径规则可以匹配临时文件路径
2. 绕过临时文件机制直接分析源文件时，路径规则正常工作
3. 对比其他工具（如null-ls）的实现，确认直接分析源文件时路径规则有效

解决方案

项目维护者提出了两种解决思路：

1. 临时文件机制可选化 - 添加配置选项允许禁用临时文件机制
2. 增强PHPStan功能 - 请求PHPStan支持从标准输入读取内容同时保留原始路径上下文

最终实现并合并了第一种方案，新增了language_server_phpstan.tmp_file_disabled配置参数，默认为false保持向后兼容，开发者可自行选择是否禁用临时文件机制。

实现细节

解决方案的核心改动包括：

1. 新增配置参数控制临时文件使用
2. 修改分析器逻辑，根据配置选择分析方式
3. 保留原有临时文件机制作为默认选项

使用建议

对于需要精确路径匹配的场景，建议：

1. 在配置中启用tmp_file_disabled选项
2. 注意这会要求文件保存后才能更新诊断结果
3. 路径规则应使用目录路径而非具体文件路径，兼容性更好

总结

这个问题揭示了静态分析工具在语言服务器环境下的特殊挑战。通过使临时文件机制可配置化，既保留了实时分析的便利性，又为需要精确路径匹配的场景提供了解决方案，体现了良好的设计平衡。