如何在 PHPStan 或 Psalm 等静态分析工具中利用 Composer 的 autoload 信息？

PHPStan 和 Psalm 依赖 Composer 的 autoload 配置（如 psr-4、files 等）来识别类、函数和命名空间，需确保 composer.json 映射准确并执行 composer dump-autoload；PSR-4 为首选，测试目录和全局函数文件需显式声明，符号未被 autoload 覆盖将导致“Class not found”等错误。

PHPStan 和 Psalm 会自动读取 Composer 的 autoload 配置（如 psr-4、psr-0、classmap 和 files），无需额外配置即可识别已声明的类、接口、函数和命名空间。关键在于确保 composer.json 中的 autoload 设置准确，且已运行 composer dump-autoload（尤其是开发时修改了映射后）。

确保 autoload 配置完整且规范

PHPStan/ Psalm 依赖 Composer 生成的 vendor/autoload.php 或其内部映射来解析符号来源。若类在代码中被引用但未被 autoload 覆盖，工具会报 “Class not found” 或 “Unable to resolve …” 类错误。

• PSR-4 是首选：推荐用 "App\": "src/" 这类清晰映射，避免路径歧义
• 不要遗漏测试目录：如果测试中用了自定义类（如 fixture 或 test helpers），需单独为 tests/ 加 autoload（例如 "Autoload\Test\": "tests/fixtures/"）
• functions.php 等全局文件要用 files：如 "files": ["src/helpers.php"]，否则 Psalm 可能无法识别其中的函数

让静态分析工具感知 vendor 外的代码

默认情况下，PHPStan/ Psalm 只扫描你指定的源目录（如 src/、tests/），但它们仍需知道这些目录里的类“该去哪找”。这时 autoload 就是桥梁。

• 在 phpstan.neon 中，通过 parameters > autoload_directories 可补充额外路径（用于未被 Composer 管理的代码）
• Psalm 使用 <autoloader></autoloader> 标签或 --autoloader 参数指向自定义加载器，但优先建议统一走 Composer autoload
• 若项目含 symlink 目录（如 Docker 开发中挂载的 src），确认 composer dump-autoload --optimize 不会跳过它们（必要时加 --no-dev 测试是否干扰）

排查 autoload 相关误报的常见操作

当工具提示“Class XXX not found”，不一定是代码错，很可能是 autoload 断链。

标签： composer 静态分析 php linux js json docker app 工具