composer如何在PHPStan或Psalm中正确识别依赖类？（stub与bootstrap配置）

phpstan 找不到 composer 自动加载的类，主因是 autoload 配置未被正确识别；需确认 composer dump-autoload 已执行、autoload-dev 类需显式指定 –autoload-file，且避免在 phpstan.neon 中误覆写 autoload_directories。

PHPStan 找不到 Composer 自动加载的类？先检查 autoload 是否生效

PHPStan 默认依赖 Composer 的自动加载机制，但它不会直接读取 vendor/autoload.php——它会自己模拟 autoloader 行为。如果类找不到，大概率不是 PHPStan 问题，而是你的项目 autoload 配置没被正确识别。

常见错误现象：class SomeVendorPackageFoo not found，但 php -r "var_dump(class_exists('SomeVendorPackageFoo'));" 返回 true。

• 确认 composer.json 中的 autoload 或 autoload-dev 已运行 composer dump-autoload（尤其是用了 psr-4 映射后新增了目录）
• PHPStan 默认只加载 autoload，不加载 autoload-dev；若测试类或辅助类在 autoload-dev 下，需显式启用：--autoload-file=vendor/autoload.php
• 避免在 phpstan.neon 中重复配置 autoload_directories 覆盖默认行为，除非你清楚自己在绕过什么

Psalm 报 “Unable to resolve class”？stubs 不是万能补丁

Stubs 是用来“告诉” Psalm 某些类存在、结构如何，但它不能替代真实加载。滥用 stubs 容易掩盖 autoload 配置问题，还可能让类型推导变弱。

使用场景：你依赖一个只含二进制的扩展（如 ext-redis），或某个包没提供 PHPDoc/PHP 8+ 类型信息，又或者你想覆盖第三方类的签名。

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

• stub 文件必须是纯 PHP（无执行逻辑），且类声明要完整（class、Interface、方法签名、返回类型）
• Psalm 不会自动扫描 stubs/ 目录；必须在 psalm.xml 中显式声明：<stubs><file name="stubs/redis-stub.php"></file></stubs>
• 别把整个 vendor/ 下的类都 stub 化——这会让 Psalm 失去对实际实现的感知，比如方法是否真被重写、参数是否可为空

PHPStan 的 bootstrapFiles 和 Psalm 的 autoloader 怎么选？

两者目的接近：让分析器提前执行一段代码，用于注册 autoloader、定义常量、或打补丁。但触发时机和风险不同。

PHPStan 的 bootstrapFiles 在分析前执行，适合加载自定义 autoloader 或 patch ComposerAutoloadClassLoader；Psalm 的 autoloader 配置则更克制，只指定入口文件路径，不鼓励执行任意逻辑。

• PHPStan 示例（phpstan.neon）：

  parameters:   bootstrapFiles:     - vendor/autoload.php     - tests/bootstrap.php

  注意：如果 tests/bootstrap.php 里有 require 循环或副作用（如修改全局状态），PHPStan 可能静默失败

• Psalm 示例（psalm.xml）：

  <autoloader>   <file name="vendor/autoload.php"/> </autoloader>

  它不会执行文件内容，只是告诉 Psalm “这些类可通过此 autoloader 加载”

• 优先用 vendor/autoload.php；只有当你用了非标准 autoloader（如 CodeIgniter 3 的 system/core/Loader.php）才考虑自定义 bootstrap

为什么加了 stub 和 bootstrap 还报错？检查类名大小写与命名空间拼写

PHPStan 和 Psalm 都严格区分大小写，且对命名空间末尾反斜杠、use 别名、以及 class_alias 支持有限。很多“找不到类”其实卡在最基础的拼写上。

常见错误现象：Class MyLibhttpClient 报错，但实际类是 MyLibHttpClientClient；或 stub 里写成了 Mylib（少了个 L）。

• 用 composer show --platform 确认扩展是否真已加载（如 ext-memcached）
• 在 stub 文件里，类声明必须和实际反射结果一致：包括 final、abstract、继承关系、接口实现
• Psalm 对 class_alias 几乎不支持；PHPStan 仅在运行时 bootstrap 中执行过 alias 才能识别——但这属于 hack，不推荐用于 CI

最麻烦的点往往藏在 composer 包的 autoload 配置里：比如用了 files 加载函数，但没声明对应函数所在文件为 stub；或者 PSR-4 映射漏掉了子目录层级。这类问题没法靠加配置解决，得回 composer.json 里一行行核对。