PHPStan必须本地安装，因其配置加载、扩展发现和规则注册均依赖项目级vendor/结构及Composer自动加载机制；全局安装会导致配置被忽略、类无法解析、扫描静默失效。

PHPStan 必须本地安装，全局安装会导致 phpstan analyse 找不到配置、跳过文件或静默失败——这不是权限或路径问题，而是其设计依赖项目级 vendor/ 和 Composer 自动加载结构。

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

PHPStan 的配置加载（phpstan.neon）、扩展发现（如 Symfony/PHPUnit 支持）、类型推导上下文都绑定在当前项目的 vendor/autoload.php 和 composer.json autoload 声明上。全局安装后，它既看不到你的 src/ PSR-4 映射，也加载不了你项目里自定义的 bootstrap.php 或 includes 规则文件。

• 现象：运行 phpstan analyse src/ 却提示 [OK] No errors，哪怕代码里有明显类型错误
• 现象：报错 Class not found，但该类明明在 src/ 且 composer dump-autoload 已执行
• 根本原因：全局二进制找不到项目 autoload 链路，所有符号解析退化为“盲猜”

如何正确安装并确保 autoload 生效

执行以下命令后，必须验证 autoload 是否被 PHPStan 实际识别：

composer require --dev phpstan/phpstan:^1.10

• 版本必须 ≥1.10.0：泛型支持已内置，无需 phpstan/phpstan-generics（该包已归档）
• 安装后立刻运行 composer dump-autoload -o，否则 PHPStan 可能无法定位你新写的类
• 检查 composer.json 中 autoload 是否覆盖全部源码目录，例如："autoload": { "psr-4": { "App\": "src/" } }
• 若含 tests/ 中的 fixture 类，需额外加 "autoload-dev" 映射，否则 PHPStan 在分析测试时会报 Class XXX not found

配置 level 和 paths 容易忽略的关键点

level 不是越高越好，paths 也不是越多越全——错误的组合会让第一次运行直接失败或掩盖真问题。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

立即学习“PHP免费学习笔记（深入）”；

• level: 5 是合理起点，level: 9 要求你已处理完泛型约束、静态返回类型、私有属性类型推断等细节
• paths 只写你真正想分析的目录；不要包含 vendor/、node_modules/ 或生成代码目录（如 src/Generated/），否则大量误报
• 若项目用 files autoload 加载全局函数（如 src/helpers.php），必须在 phpstan.neon 中显式声明：parameters: { autoload_files: ["src/helpers.php"] }，否则函数调用会被判为 undefined
• 排除路径用 excludePaths，不是注释掉 paths 条目——后者会导致整个目录不扫描

CI 中运行失败的常见真实原因

GitLab CI 或 GitHub Actions 里 phpstan analyse 报错，90% 不是 PHPStan 本身问题，而是环境链路断裂。

• 忘记在 CI 脚本中运行 composer install --no-interaction --prefer-dist，导致 vendor/ 缺失
• CI 使用缓存但未更新 composer.lock，旧 lock 文件锁死 phpstan/phpstan 在 0.x 版本，泛型直接失效
• 配置文件名写成 phpstan.yaml 或 phpstan.yml：PHPStan 只认 .neon 后缀
• CI 运行用户无权读取 phpstan.neon（尤其 Docker 场景），报错看似是“找不到配置”，实则是权限拒绝

最常被跳过的动作：在改完 composer.json autoload 或升级 PHPStan 后，没运行 composer dump-autoload 就直接跑 phpstan analyse——此时 PHPStan 看到的类图谱仍是旧的，连最基本的命名空间都对不上。