如何利用Composer进行静态代码分析？集成PHPStan实战指南-composer-PHP中文网

phpstan必须本地安装，全局安装会导致配置不加载、类找不到、扫描静默失效；正确做法是项目根目录执行composer require --dev phpstan/phpstan并配置phpstan.neon于根目录。

如何利用composer进行静态代码分析？集成phpstan实战指南

PHPStan 必须本地安装，全局安装等于没装——配置不加载、类找不到、扫描静默失效。这不是 bug，是设计使然。

失败通常不是网络或权限问题，而是环境或版本链路断了。

在子目录（如 src/ 或 tests/）里执行命令：必须回到项目根目录（含 composer.json）再运行
composer.json 里已有旧版锁定（比如 "phpstan/phpstan": "^0.12"）：手动改成 "^1.10" 或 "^2.0"，再执行 composer update phpstan/phpstan
误用过 composer global require phpstan/phpstan：先运行 composer global remove phpstan/phpstan，再重装本地版
装了 nunomaduro/larastan 却没装 phpstan/phpstan：Larastan 是扩展包，不是可执行主体，缺核心就报 Command not defined

运行 vendor/bin/phpstan analyse 显示 [OK] No errors，但代码里明显有类型错误或未定义方法调用——说明配置根本没被读到。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

文件名必须是 phpstan.neon（不能是 phpstan.yaml、.neon、phpstan.neon.dist）且放在项目根目录
必须包含 parameters: 块，level 和 paths 要在其下缩进（YAML 对空格敏感，推荐用 2 空格）
paths 默认只扫 src/；Laravel 项目要加 - app/、- database/、- routes/，否则直接跳过
纯函数文件（如 src/helpers.php）无命名空间：必须显式写 autoload_files: ["src/helpers.php"]，否则函数调用全标为 undefined

PHPStan 不会主动提示“配置没读到”，它只会安静 fallback 到 level 0 + 只扫 src/ + 跳过所有 autoload 映射。最快速验证方式：

运行 vendor/bin/phpstan analyse --debug，看输出里 Loaded configuration 是否指向你写的 phpstan.neon
检查 Scanning files in 后列出的路径是否包含你预期的目录（如 app/Models/User.php）
若看到 Using bootstrap file: vendor/autoload.php，说明自动加载链路通；若没这行，autoload_files 或 composer dump-autoload -o 没到位
CI 环境中常见陷阱：phpstan.neon 被 .gitignore 忽略、composer install --no-dev 跳过了 dev 依赖、工作目录不是项目根目录

这不是 PHPStan 的问题，是它默认不认识 Laravel 的运行时特性（Facade、模型属性、容器绑定）。必须补两层：

装三个包： composer require --dev phpstan/phpstan phpstan/phpstan-laravel phpstan/extension-installer ——漏掉 phpstan/extension-installer，扩展规则不会自动加载
在 phpstan.neon 中显式引入扩展：includes: - vendor/phpstan/phpstan-laravel/extension.neon
启用模型扫描（可选但推荐）：parameters: { scanModels: true }，否则 User::$name 这类属性始终报错
别把 tests/ 加进 paths 却不配 autoload-dev：否则测试里用的 TestCase 类会报 Class not found