用途:在 WordPress PHP 代码库中配置、运行并修复 PHPStan 静态分析问题,适用于设置或更新 phpstan.neon / phpstan.neon.dist、生成或更新 phpstan-baseline.neon、通过 WordPress 友好的 PHPDoc 修复报错(REST 请求、钩子、查询结果),以及安全处理第三方插件/主题类。
前置输入:需先获得 wp-project-triage 输出;确认是否允许增改 Composer 开发依赖(stubs);确认本任务是否允许改动基线。
主要步骤:先用 node skills/wp-phpstan/scripts/phpstan_inspect.mjs 探测现有配置与脚本,优先使用仓库已有的 composer run phpstan。加载 WordPress 核心 stubs(szepeviktor/phpstan-wordpress 或 php-stubs/wordpress-stubs 基本必需),否则会大量报未定义核心函数。配置时路径聚焦一方代码,排除 vendor/、node_modules/、构建产物,ignoreErrors 保持窄范围并有说明。修复优先改类型而非忽略:REST 端点用 WP_REST_Request<...>、钩子回调补 @param 类型、查询结果用数组形状、Action Scheduler 的 $args 数组形状。第三方类先确认真实依赖,优先用已有 stubs(如 php-stubs/woocommerce-stubs、php-stubs/acf-pro-stubs),仍无法解析时按具体 vendor 前缀加窄忽略。基线仅作迁移工具,存量代码生成一次后逐步缩减,不为新错误加基线。
验证:用探测到的命令运行 PHPStan,确认基线被包含且未异常增长,改动 ignoreErrors 后重跑确认未掩盖无关问题。
限制与失败模式:出现“Class not found”时检查自动加载/stubs 或加窄忽略;开启后报错过多可缩小路径、加 excludePaths、从低级别起步再逐步提升;钩子/REST 参数类型不一致优先补 PHPDoc。若类型依赖无法确认的第三方 API,应先询问依赖版本或源码;新增 Composer 依赖需先征得用户同意。