Webman项目集成PHPStan必须本地安装、配置phpstan.neon并显式加载框架自动加载逻辑，否则会大量报Call to undefined method或Undefined variable；需在项目根目录执行composer require --dev phpstan/phpstan，配置bootstrapFiles指向start.php，autoload_files声明helper文件，paths覆盖app/、config/等实际目录，并避免安装Laravel/Symfony扩展。
Webman 项目集成 PHPStan 必须本地安装、配置 phpstan.neon 并显式加载框架自动加载逻辑，否则会大量报 Call to undefined method 或 Undefined variable —— 这不是代码问题，是 PHPStan 没识别 Webman 的容器绑定和魔术方法。
composer require --dev phpstan/phpstan 必须在项目根目录执行
Webman 的入口是 start.php，但 composer 管理仍以 composer.json 所在目录为根。常见错误：
- 在
app/或config/下执行composer require --dev phpstan/phpstan：vendor 生成在子目录，vendor/bin/phpstan不可用 - 已全局安装过
phpstan/phpstan：先运行composer global remove phpstan/phpstan，再回到项目根目录重装 - composer.json 中锁定了旧版（如
"phpstan/phpstan": "^0.12"）：手动改为"^1.10"或"^2.0"，再执行composer update phpstan/phpstan
phpstan.neon 必须包含 bootstrapFiles 和 autoload_files
Webman 不走标准 PSR-4 自动加载路径（如 src/），而是通过 start.php + Container::set() 绑定服务，PHPStan 默认无法推断 $this->redis、$this->db 等动态属性。解决方式：
- 文件名必须是
phpstan.neon（不是.neon、phpstan.yaml），放在项目根目录 -
parameters:块下必须缩进写bootstrapFiles，指向 Webman 启动入口：- start.php（或- bootstrap/start.php，依实际路径调整） - 若用了全局 helper 函数（如
app()、config()），需显式声明：autoload_files: ["app/Helper.php"] -
paths要覆盖实际代码目录：- app/、- config/、- route/、- support/（Webman 常见结构），不能只写src/
Webman 特有误报的抑制方式
PHPStan 报 Call to undefined method Webman\Container::get() 或 Undefined variable $request 是典型信号——它没执行 start.php，或没加载容器定义。验证方法：
立即学习“PHP免费学习笔记（深入）”；
- 运行
vendor/bin/phpstan analyse --debug - 检查输出中是否有
Using bootstrap file: start.php；没有则bootstrapFiles配置无效 - 检查
Scanning files in是否列出app/Controller/Home.php类文件；没有说明paths写错 - 若仍有误报，用注释精准抑制：
// @phpstan-ignore-next-line放在调用行上方，或类头部加/** @property-read \Redis $redis */
Laravel/Symfony 扩展不适用于 Webman
别装 phpstan/phpstan-laravel 或 phpstan/phpstan-symfony，它们依赖框架专属生命周期和配置解析机制，对 Webman 无效甚至引发冲突。Webman 的解决方案更轻量：
- 靠
bootstrapFiles加载start.php，让 PHPStan 执行一次容器初始化 - 靠
autoload_files加载自定义 helper 文件，补全函数签名 - 靠
includes引入自定义 stub（如手写webman-stubs.neon声明Container方法返回类型） - CI 中确保
composer install --no-dev不被误用：PHPStan 是--dev依赖，必须保留
最易被忽略的是 start.php 里是否含 require_once __DIR__ . '/vendor/autoload.php'; —— 若 Webman 项目删了这行或改用其他 autoloader，PHPStan 就彻底失去类解析能力，所有扫描都 fallback 到 level 0 且静默失效。
