如何解决PHP代码静态分析问题？使用Composer安装PHPStan吧！-composer-PHP中文网

PHPStan 必须本地安装，因全局安装会导致配置失效、扩展不注册、autoload_files 失效；Laravel 项目还需同时安装 phpstan/extension-installer 和 phpstan/phpstan-laravel 才能正确解析 Facade、Eloquent 和容器绑定。

如何解决php代码静态分析问题？使用composer安装phpstan吧！

PHPStan 必须本地安装，全局安装会导致 phpstan.neon 配置被忽略、扩展不注册、autoload_files 失效，甚至静默跳过文件——这不是配置问题，是根本没走对加载路径。

为什么不能用 composer global require phpstan/phpstan

PHPStan 的配置发现、扩展自动注册（如 phpstan-laravel）、bootstrapFiles 加载，全部依赖 Composer 的本地 vendor/ 目录结构和 autoloader。全局安装后，vendor/bin/phpstan 启动时找不到项目级 composer.json 和 autoload.php，直接退化为“裸运行”，所有自定义规则失效。

现象：运行 ./vendor/bin/phpstan analyse 却提示 Class not found 且无堆栈，或完全不报错但跳过 app/ 目录
验证方式：执行 php -r "var_dump(class_exists('PHPStan\Analyser\NodeScopeResolver'));" —— 若返回 bool(false)，说明 autoloader 没加载成功
正确做法：只在项目根目录执行 composer require --dev phpstan/phpstan

Laravel 项目必须装的三个包

只装 phpstan/phpstan 在 Laravel 中等于白装：Facade 解析失败、Eloquent 属性推断为空、容器绑定类型丢失。官方扩展依赖 phpstan/extension-installer 才能自动挂载。

缺 phpstan/extension-installer：即使装了 phpstan/phpstan-laravel，includes 也不会自动生效，scanModels: true 形同虚设
缺 phpstan/phpstan-laravel：Auth::user() 返回 mixed，User::first() 不推断为 User|null
命令必须一次性执行：composer require --dev phpstan/phpstan phpstan/phpstan-laravel phpstan/extension-installer
检查是否生效：运行 ./vendor/bin/phpstan analyse --debug app/Http/Controllers，若看到 Loading extension from vendor/phpstan/phpstan-laravel/extension.neon 行，说明加载成功

phpstan.neon 配置里最容易写错的三处

phpstan.neon 不是模板粘贴就行，路径、级别、包含逻辑稍有偏差就导致分析范围失控或规则不触发。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

paths: 下写成 - ./src 或 - src/（末尾斜杠缺失）——部分版本会跳过子目录，统一用 - src/（带尾部斜杠）
level: 设为 9 却没配 bootstrapFiles: 加载模型工厂，database/factories/*.php 中的类无法解析，直接报大量 Class not found
includes: 写 - vendor/phpstan/phpstan-laravel/extension.neon 但没确认该路径存在——Laravel 项目应优先用 phpstan/extension-installer 自动处理，手动 include 容易路径错误

推荐最小可用配置（Laravel）：

includes:
    - vendor/phpstan/phpstan-laravel/extension.neon
parameters:
    level: 5
    paths:
        - app/
        - database/
        - routes/
        - tests/
    bootstrapFiles:
        - database/factories/UserFactory.php

泛型支持要升级到 v1.10+，别碰 phpstan-generics

PHPStan 自 v1.10 起已原生支持泛型（Collection<user></user> 级别推断），旧版 phpstan/phpstan-generics 包已被归档并明确标注 deprecated。

错误操作：执行 composer require --dev phpstan/phpstan-generics → 安装失败或与主包冲突
正确操作：检查 composer.json 中 "phpstan/phpstan": "^0.12" 这类旧约束，手动改为 "^1.10"，再运行 composer update phpstan/phpstan
验证是否启用：在代码中写 $users = new Collection<user>(); $users->first()->getName();</user>，若未报错说明泛型解析正常

最常被忽略的是 bootstrapFiles 和 phpstan/extension-installer 的组合效果——它们不是可选项，而是 Laravel 项目让 PHPStan “看懂”框架语法的基础设施。漏掉任何一个，分析结果就只是“语法检查”，不是“框架感知的静态分析”。