PHPStan 必须用 composer require --dev 安装以避免污染生产环境，因其非运行时库且可能引发类冲突或引入测试依赖；需在 phpstan.neon 中配置 paths 和 autoload_files 以覆盖自定义类路径；遇 Cannot use 'static' as class name 错误应优先重命名类而非忽略。
PHPStan 能在不运行代码的前提下发现类型错误、未定义方法调用、空值解引用等隐患，但直接 composer require 到生产环境会污染依赖，必须用 require-dev 安装并配置自动加载隔离。
为什么不能用 composer require phpstan/phpstan？
这条命令默认写入 require（非开发依赖），导致 PHPStan 的类和 autoloader 被加载进生产环境——它本身不是运行时库，且其分析器类可能与项目中同名类冲突。更严重的是，某些插件（如 phpstan-phpunit）会偷偷引入测试框架依赖，破坏生产环境纯净性。
正确做法是：
- 始终加
--dev参数：composer require --dev phpstan/phpstan - 确认
composer.json中出现在require-dev字段下，而非require - 检查
autoload-dev是否未意外包含 PHPStan 相关路径（一般不需要配）
如何让 PHPStan 扫描到自定义类和 trait？
PHPStan 默认只分析 src/ 和 tests/，如果你的类放在 app/、lib/ 或使用了 PSR-4 以外的加载方式（如 include_once），它会报“Class not found”或跳过分析。
立即学习“PHP免费学习笔记（深入）”；
解决方式有两个层级：
- 在
phpstan.neon中显式声明扫描目录：paths:下添加- app、- lib - 若类通过非标准方式加载（如全局函数注册），需用
autoload_files加载引导文件：autoload_files: [app/bootstrap_for_phpstan.php]，该文件应仅做include不执行逻辑 - 确保
composer.json的autoload和autoload-dev已正确映射，否则 PHPStan 的反射无法解析类名
phpstan analyse 报错 “Cannot use ‘static’ as class name” 怎么办？
这是 PHPStan 0.12+ 对 PHP 8.1+ 新增的保留标识符校验，而你的代码里可能有旧版框架（如 Laravel 5.x、早期 Symfony Bundle）用了 class static 作类名——语法合法但语义危险。PHPStan 拦住它是对的。
临时绕过（仅限迁移期）：
- 在
phpstan.neon中加规则屏蔽：ignoreErrors:下写- '#Cannot use \'static\' as class name#' - 但更推荐直接重命名类，因为 PHP 8.1 运行时也会报
E_DEPRECATED - 注意：不要用
excludes_analyse排除整个文件，那等于放弃对该文件的全部静态检查
PHPStan 的真正门槛不在安装，而在配置与项目结构对齐——特别是当项目混用 Composer 自动加载、手动 include、动态 class_alias 时，漏掉一个路径或 autoload 配置，就等于关掉了半数检查能力。
