PHPStan 可在运行前检测类型不匹配、未定义方法、空值解引用等错误：先安装并启用 strict_types，再配置 phpstan.neon 指定 level 和 paths，通过分析报告定位问题，修复时优先添加类型声明或 PHPDoc 注解，并确保 autoload 正确配置。
如果您在开发 PHP 应用时遇到运行时才暴露的类型不匹配、未定义方法调用或空值解引用等问题，很可能是代码中存在静态可识别的类型错误。PHPStan 无需执行代码即可在编译前阶段发现这些隐患。以下是使用 PHPStan 检测并定位类型错误的具体操作路径：
一、安装 PHPStan 并启用严格模式
安装 PHPStan 是启动静态分析的第一步，必须确保其作为开发依赖被正确引入，并启用严格类型推断能力，否则大量类型错误将无法被捕获。
1、打开终端，进入项目根目录。
2、执行命令：composer require --dev phpstan/phpstan。
立即学习“PHP免费学习笔记（深入）”；
3、运行 vendor/bin/phpstan --version 验证安装成功。
4、确认项目中已启用 declare(strict_types=1); 声明（建议在所有 PHP 文件顶部添加），以协同 PHPStan 进行强类型校验。
二、创建并配置 phpstan.neon 文件
PHPStan 默认仅检测语法解析错误，必须通过配置文件显式指定分析级别与作用域，否则类名不可见、方法签名不校验、路径未覆盖等问题将导致类型错误漏报。
1、在项目根目录新建文件：phpstan.neon。
2、写入以下内容（适配标准 Composer 结构）：
parameters:
level: 5
paths:
- src/
- tests/
autoload_files:
- vendor/autoload.php
3、保存后执行 vendor/bin/phpstan analyse --configuration=phpstan.neon 测试配置有效性。
三、识别并解读典型类型错误报告
PHPStan 的输出信息直接指向类型契约断裂点，需结合上下文理解其语义含义，而非仅视作警告忽略。关键错误格式具有固定结构，便于快速定位根源。
1、观察终端输出中形如 Parameter #1 $id of User::find() expects int, string given. 的报错。
2、该提示表明：方法声明要求第一个参数为 int，但调用处传入了 string。
3、查找对应调用行，检查变量来源——是否来自 $_GET、$_POST 或 JSON 解码结果，这些输入默认为字符串，需显式转换。
4、若报错为 Call to an undefined method App\Model\Order::getTotalAmount().，说明 PHPStan 未能识别对象实际类型，通常因工厂返回值无类型注解或动态构造导致。
四、修复函数参数与返回值类型错误
修复动作应优先修改源码类型契约，而非压制警告；PHPStan 推荐通过 PHPDoc 注解、类型声明或重构数据流来建立可推断的类型路径。
1、为函数添加完整类型声明，例如将 function calculate($a, $b) { return $a * $b; } 改为 function calculate(float $a, float $b): float { return $a * $b; }。
2、对动态获取的对象添加 PHPDoc 类型提示，例如在工厂调用后插入：/** @var UserService $service */。
3、若参数来自外部输入（如请求参数），在使用前强制类型转换：$userId = (int) $_GET['id'] ?? 0;，并确保后续逻辑基于该转换后变量展开。
4、对返回数组的函数，使用 PHPDoc 明确结构：/** @return array{id: int, name: string} */。
五、处理“Class not found”与自动加载失效问题
当 PHPStan 报出大量 “Class not found” 错误时，并非代码本身有误，而是其类加载机制未被正确激活，导致类型上下文缺失，进而使所有基于类的方法调用、属性访问和继承关系判断全部失效。
1、检查 phpstan.neon 中 autoload_files 是否包含 vendor/autoload.php，且路径拼写准确无误。
2、确认项目中 composer.json 的 "autoload" 或 "autoload-dev" 字段已正确定义命名空间与路径映射。
3、若使用自定义加载逻辑（如手动 require_once），需将其路径添加至 phpstan.neon 的 autoload_files 列表。
4、运行 composer dump-autoload 确保自动加载器最新，再重新执行 PHPStan 分析。
