PhpStorm 2026.2 Help

Mess Detector

このページで、Mess Detector 品質ツールを有効化して設定します。

項目

説明

構成

リストから必要なインタープリターを選択します。 リストには、現在設定されているすべてのローカルおよびリモート PHP インタープリターが含まれています。 詳細については、 ローカル PHP インタープリターを構成するリモート PHP インタープリターの構成 を参照してください。

ドロップダウンリストの右側にある 閲覧ボタン をクリックすると、 Mess Detector ダイアログ が開きます。

無視対象ファイルの表示

クリックすると Mess Detector 無視されたファイル ダイアログが開き、Mess Detector がスキップするファイルが一覧表示されます。 PhpStorm は、インスペクション中に Mess Detector からの応答を待機する時間が ツールプロセスのタイムアウト フィールドで指定された上限を超えた場合、新しいファイルをリストに追加することを提案します。 これは処理が遅くなるのを防ぐために行われます。 各ファイルについて、PhpStorm はその名前と場所を表示します。

  • ファイルを追加するには、 追加ボタン をクリックし、表示されるダイアログで目的のファイルを探します。

  • リストからファイルを削除して Mess Detector に再度処理させるには、ファイルを選択して ファイルの除去 ボタン 削除ボタン をクリックします。

  • 一覧からすべてのファイルを削除するには、 閉じるボタン をクリックします。

オプション

  • 事前定義されたルール(英語)を使用するには、 オプション 領域で、実行する検証の横にあるチェックボックスを選択します。

  • カスタムルールセットを使用するには:

    1. 1 つまたは複数の ルールセットファイルを作成して保存します。 有効な ルールセットファイルはname 属性を持つ <ruleset> ルート要素を含む .xml ファイルです。 カスタムルールセットの詳細については、 http://phpmd.org/documentation/creating-a-ruleset.html を参照してください。

    2. カスタムルールセット エリアで、 追加ボタン をクリックし、開いたダイアログで関連するルール定義ファイルを選択します。 OK をクリックすると、新しいアイテムが カスタムルールセット リストに追加され、その 命名 フィールドには <ruleset> タグ内の name 属性から取得したルールセット名が表示され、 ファイル フィールドには選択したルールセットファイルの場所が表示されます。

実行モード

Mess Detector がコードを解析する実行頻度を設定します:

  • 外出先で – Mess Detector はバックグラウンドで自動的に実行されます。 入力中に問題がエディターでハイライトされます。

  • アイドル時 – Mess Detector は文字入力後、 アイドルしきい値 (ms): フィールドで指定した無操作時間が経過すると実行されます。

  • 保存時 – Mess Detector はファイルが手動で保存されるか、PhpStorm の自動保存で保存された時のみ実行されます。 ファイル状態がディスクに保存されたときのみ、問題のハイライトが更新されます。

アイドルしきい値 (ms):

コードを修正した後、Mess Detector が実行されるまでの遅延時間(ミリ秒)を設定します。

最小間隔 (ms):

同じファイルで Mess Detector を連続実行する際に必要な最小経過時間(ミリ秒)を設定します。 これにより、ファイルの頻繁な保存や大量の文字入力があった場合でも、Mess Detector の過度な実行を防げます。

Mess Detector ダイアログ

Mess Detector ページの 構成 リストの隣にある 閲覧ボタン をクリックするとダイアログが開きます。

このダイアログを使用して、使用する PHP インタープリター、Mess Detector 実行可能ファイルへのパス、および Mess Detector の動作を構成します。 詳細は Mess Detector を参照してください。

項目

説明

インタープリターペイン

ダイアログの左側のペインには、Mess Detector を使用するデフォルトの PHP インタープリターが表示されます。 別のインタープリターを追加するには、 追加ボタン をクリックし、プロジェクトで構成された CLI インタープリター のリストから項目を選択します。

Mess Detector パス

このフィールドで、Mess Detector スクリプトの場所を指定します。Windows の場合は phpmd.bat 、Linux または macOS の場合は phpmd です。

PhpStorm は、 vendor/bin フォルダー内の Mess Detector 実行可能ファイルへのパスを検出し、フィールドに自動的に入力しますが、必要に応じて編集できます。 パスを手動で入力するか、 閲覧ボタン をクリックして開いたダイアログでパスを選択します。

phpmd.bat または phpmd への指定されたパスが PhpStorm と Mess Detector 間の相互作用を保証すること、つまりツールが PhpStorm から起動でき、PhpStorm がそこから問題レポートを受信することを確認するには、 検証 ボタンをクリックします。 この検証は、 phpmd --version コマンドの実行と同じです。 検証に成功すると、PhpStorm は検出された Mess Detector バージョンに関する情報を表示します。

ツールプロセスのタイムアウト

このフィールドでは、PhpStorm が Mess Detector からの結果を待つ時間を指定します。 タイムアウトを超えると、CPU とメモリの過度の使用を防ぐためにプロセスが終了します。 これにより、コンピューターの構成と使用するルールセットに応じて、Mess Detector プロセスの動作を微調整できます。

2026 年 7 月 14 日