WordPress PHPStan レビュースキル

概要

WordPress プロジェクトにおける PHPStan のシステマティックなレビューガイダンス。基本原則: スタティック分析は実際のバグを検出するのに十分厳密であるべきだが、ノイズになるべきではなく、WordPress 固有のエクステンションやスタブは意図的に配線されるべきです。設定ファイル、インクルード、ベースライン、CI 統合、分析パス、ブートストラップファイル、WordPress スタブ、段階的導入戦略についてレビューします。

使用場面

以下の場合に使用:

• phpstan.neon、phpstan.neon.dist、または CI 設定をレビューするとき
• WordPress プラグインまたはテーマで PHPStan 導入を計画しているとき
• ベースラインの使用または無視されたエラーを監査するとき
• szepeviktor/phpstan-wordpress 設定をレビューするとき
• 分析スコープ、ブートストラップファイル、またはスタブ設定を確認するとき

以下の場合は使用しない:

• ランタイムパフォーマンスのレビュー
• スタティック分析フォーカスなしの PHPUnit またはブラウザテスト戦略
• 分析設定と無関係な一般的な PHP リファクタリング

コードレビューワークフロー

1. 分析エントリーポイントを特定する

   • phpstan.neon / phpstan.neon.dist
   • Composer require-dev
   • CI ワークフローとスクリプト
   • ブートストラップまたはスタブファイル

2. ベース設定をまず確認する

   • 設定ファイル名とインクルード
   • レベルと分析対象パス
   • 除外とブートストラップファイル
   • WordPress 固有のエクステンション/スタブが実際に読み込まれているか確認

3. ベースラインと無視戦略をレビューする

   • ベースラインは分析段階的導入に使用され、新しい問題を永遠に隠すためのものではない
   • 無視されたエラーは意図的で確認可能である
   • 新しいコードはより高い基準を守られている

4. CI の使いやすさをレビューする

   • 決定論的なコマンド
   • 正しい設定パス
   • 合理的な失敗動作
   • ローカルと CI 設定間の予期しないドリフトがない

5. 結果を分類する

   • CRITICAL: PHPStan は設定されているように見えるが実際にはプロジェクトコードを分析していない、WordPress エクステンションが欠けている、ベースラインがすべてを無期限に隠している
   • WARNING: 除外が広すぎる、ベースラインワークフローが古い、設定の分割が混乱している、分析パスが狭すぎる
   • INFO: レベルを上げる、ブートストラップ動作を文書化する、無視をより厳密にすることができる

ファイル種別ごとのチェック

PHPStan 設定

• CRITICAL: 設定が意味のあるプロジェクトパスを分析していない
• WARNING: ignoreErrors または除外が広すぎる
• WARNING: WordPress エクステンションがインストールされているがエクステンションインストーラーが存在しない場合に含まれていない
• INFO: ローカルオーバーライドを phpstan.neon に分割し、コミットされた .dist ファイルの上に配置できる

ベースラインファイル

• WARNING: ベースラインが意図的に修正する代わりに気軽に再生成されている
• WARNING: 分析がまだ不足しているように見えるときにベースラインが使用されている
• INFO: 更新すべき場合と結果を修正すべき場合についてドキュメント化できる

CI と Composer

• WARNING: CI コマンドが文書化されたローカルコマンドと本質的に異なる
• WARNING: require-dev にスタブ/エクステンションが含まれているが設定が正しく使用していない
• INFO: より明確なスクリプトまたは出力フォーマットを追加できる

クイック検出用の検索パターン (PST-21)

これらの rg コマンドを使用して PHPStan 設定を素早く検出します。

設定と CI の発見

rg -n "phpstan|phpstan\\.neon|phpstan\\.neon\\.dist|phpstan-baseline" . -g '*.{neon,php,json,md,yml,yaml}'
rg -n "vendor/bin/phpstan|composer .*phpstan|phpstan analyse" . -g '*.{json,md,yml,yaml,sh}'

WordPress 固有の設定

rg -n "szepeviktor/phpstan-wordpress|php-stubs/wordpress-stubs|extension\\.neon" . -g '*.{json,neon,md}'
rg -n "bootstrapFiles|scanFiles|scanDirectories|paths|ignoreErrors|includes:" . -g '*.neon*'

リファレンスファイル

• references/config-and-bootstrap.md - 設定構造、インクルード、分析対象パス、ブートストラップファイル、WordPress エクステンション配線
• references/baseline-and-ci.md - ベースライン戦略、CI 統合、ロールアウトヒューリスティクス
• references/wordpress-stubs-guide.md - phpstan-wordpress、WordPress スタブ、一般的な WordPress スタティック分析のトレードオフ
• references/sample-phpstan.neon.dist - WordPress プラグインまたはテーマ向けのサンプル共有設定ファイル

出力形式 (PST-23)

各結果について以下を含めます:

1. 重要度: CRITICAL、WARNING、または INFO
2. ファイルと行番号
3. スタティック分析の問題の概要
4. WordPress PHPStan カバレッジまたはシグナル品質にとって重要な理由
5. 推奨される修正

問題が見つからない場合は、それを明確に述べ、ベースライン成長、狭い分析スコープ、文書化されていないローカルオーバーライドなど、残存するリスクに言及します。