PHPStan是PHP静态分析最实用工具，不依赖运行时，能发现类型错误、未定义变量等问题，相比PHP_CodeSniffer和Psalm更平衡；需配合扩展支持Laravel/Symfony魔法方法，避免误报应精准抑制而非全局关闭规则。
PHP静态分析该用哪个工具
PHP项目做静态分析，phpstan 是当前最实用的选择。它不依赖运行时环境，能直接扫描源码发现类型不匹配、未定义变量、死代码等问题；相比 phpcs（专注编码规范）和 psalm（配置复杂、学习成本高），phpstan 在准确率、易上手和 CI 集成方面更平衡。
常见错误现象：用 phpcs 当静态分析主力，结果漏掉 Call to an undefined method 这类严重问题；或者强行用 psalm 开启严格模式却因大量 false positive 被迫弃用。
-
phpstan默认级别 0 就能捕获基础逻辑错误，建议从--level=2开始渐进启用 - 避免全局安装：用
composer require --dev phpstan/phpstan锁定版本，防止团队环境不一致 - 它不检查 PHP 语法错误（那是
php -l的事），也不替代单元测试
怎么绕过“Undefined variable”误报
phpstan 在处理动态变量、模板赋值或框架魔术方法时，常把合法代码标为 Undefined variable。这不是 bug，是它默认不信任动态作用域。
正确做法不是关掉整个规则，而是精准抑制：
立即学习“PHP免费学习笔记（深入）”；
- 在变量首次使用前加注释：
// @var string $user_name - 对整行误报加
// @phpstan-ignore-next-line - 若某类方法返回动态属性（如 Laravel 的
__get），在类头部加/** @property-read string $name */ - 避免滥用
phpstan.neon中的ignoreErrors全局屏蔽，否则会掩盖真实问题
如何让 PHPStan 支持 Laravel 或 Symfony 的魔法行为
Laravel 的 $request->input()、Eloquent 的 $model->attribute 这类调用，phpstan 默认无法推断返回类型，会报错。
必须引入对应扩展包，而不是靠自己写 stub：
- Laravel：装
phpstan/phpstan-laravel，并确保bootstrap/app.php被正确加载（通过phpstan.neon的bootstrapFiles配置） - Symfony：用
phpstan/phpstan-symfony，它能解析services.yaml推断容器中对象类型 - 自定义 helper 函数？在
phpstan.neon里配includes引入你自己的phpstan-extensions.neon - 别手动复制框架的
.phpstorm.meta.php到 phpstan —— 它不识别那种格式
CI 中跑 PHPStan 卡住或超时怎么办
本地快，CI 慢，甚至超时退出，通常不是性能问题，而是路径或 autoloader 配置偏差。
关键检查点：
- 确认
phpstan.neon中的paths只包含 src/ 和 tests/，排除vendor/、storage/、node_modules/ - CI 环境没装 xdebug ——
phpstan在 xdebug 启用时会显著变慢，加php -d xdebug.mode=off vendor/bin/phpstan - 用
--configuration=phpstan.ci.neon分离 CI 配置，在里面设memory_limit: 1G和level: 3（比本地低一级，保速度） - 如果用了 Docker，确保挂载的代码路径没有意外包含大体积日志或缓存文件
最常被忽略的是：某些 IDE 自动生成的 .phpstorm.meta.php 或 _ide_helper.php 文件被 phpstan 扫描了，它们体积大、结构怪，直接拖垮分析速度——加到 excludePaths 里。
