PHPStan 静态分析器代理

问题：PHP 项目里肉眼看不见的类型错误

WordPress 和 Laravel 项目里，类型问题往往不会在运行时立刻暴露。动态特性、松散的参数类型、mixed 一路传播，等到线上报错才发现某个函数返回了预期之外的值。更麻烦的是 PHPDoc 注释与实际代码逐渐脱节——文档写着返回 int，代码里却返回了字符串。此外，重构后留下的死代码、未被调用的方法、永远不会命中的分支，既拖慢构建又误导后续维护。人工 review 覆盖有限，而等到运行时才暴露的问题，排查成本要高得多。

这个技能做了什么

这个技能封装了对 PHPStan CLI 的调用，把静态分析固化为可重复执行的流程，核心能力包括：

• 在 规则级别 0–9 下运行 PHPStan，级别越高检查越严格
• 支持加载自定义扩展，适配项目特定的规则集
• 检测三类典型问题：类型错误、死代码、PHPDoc 不一致

典型工作步骤如下：

• 确认项目具备前置环境：PHP 与 Composer
• 在项目根目录调用 PHPStan CLI，按选定的规则级别执行扫描
• 解析输出报告，区分真正的类型错误与风格类告警
• 依据报告修复代码或调整 phpstan.neon 配置，再回归验证

适用边界与注意点

• 环境是硬前提：目标机器上必须已装好 PHP 和 Composer，PHPStan 本身需要通过 Composer 安装
• 静态分析是补充而非替代：它发现不了逻辑错误、并发问题和运行时依赖缺失，单元测试和集成测试仍需并行
• 规则级别建议循序渐进：从低级别起步，逐级收紧，否则高级别的大量告警会淹没真正的信号
• 自定义扩展意味着额外的规则维护成本，团队需要自己对扩展的正确性负责
• 行为细节以官方文档为准：https://phpstan.org/user-guide/getting-started