構造検索と置換

従来の検索プロセスでは、ソースコードの構文とセマンティクスが考慮されていません。正規表現を利用しても、PhpStorm はコードを通常のテキストとして扱います。構造検索および置換（SSR ）アクションを使用すると、コード構造を考慮して、コード内の特定のコードパターンまたは文法構造を検索できます。

PhpStorm は、作成した検索テンプレートと適用した条件に基づいてソースコードの断片を検索・置換します。

ターゲットを構造的に検索する

メインメニューで編集 | 検索 | 構造検索に移動して、構造検索ダイアログを開きます。
構造置換ダイアログにすばやく切り替えるには、をクリックします。
構造検索ダイアログで、次のいずれかの操作を行います。
- テンプレートを一から作成するには、テンプレート一覧から下書きテンプレートを選択し、エディターエリアにコードテンプレートを入力します（例： $variable$ でコードを表現）。
  カスタムテンプレートを将来使用するために保存するには、ダイアログツールバーのテンプレートを保存アイコン（）をクリックします。テンプレートをインスペクションとして保存することもできます。
  PhpStorm は、作成したテンプレートをテンプレートリストの最近ノードに追加します。
- 既存のテンプレートをプロトタイプとして利用する場合は、利用可能な既存テンプレート一覧から必要なテンプレートを選択します。
  class ExampleClass { public function WRONG() { } public function right() { } }
  クラス内で特定のメソッドを見つけましょう。
  既存のテンプレートの一覧から、 PHP | 一般のクラスのすべての public メソッドテンプレートを選択します。
  プロジェクト全体でこれらの構造を検索するには、検索をクリックします。
  PhpStorm はエディターで見つかったコード出現箇所を即座にハイライトします。
構造検索ダイアログには、選択したテンプレートとそのフィルターの値が表示されます。既存のフィルターを編集したり、新しい条件を追加したりできます。コード変数にキャレットを置き、フィルター領域を使用してフィルターを管理します。
例: $b$ 変数に条件を追加します。
テキスト修飾子の場合は、次の正規表現を入力します。
\b[a-z]\w+\b
この場合、構造検索ダイアログで大文字小文字を区別チェックボックスを選択すると、PhpStorm は最初のフィールドに小文字が含まれるフィールドのみを検索します。
選択した言語に応じて、追加のオプションも利用できます。
例: 次のオプションを確認します。
- 言語: リストを使用して、検索に含めるファイルの種類を選択します。この場合は PHP です。
- ターゲット：リストを使って検索する項目を選択します。この場合は b です。
- 再帰：選択すると、PhpStorm が再帰的に検索を行い、すべてのネストされた項目が結果に含まれます。例えば、再帰を有効化してメソッド呼び出しを検索すると、PhpStorm は foo(foo(foo())) 内のネストされた呼び出しを見つけます。再帰を無効にすると、外側の呼び出しのみが検索されます。
- 挿入されたコード: 選択すると、HTML 内の JavaScript や Java 内の SQL などの挿入されたコードも検索に含まれます。
- 大文字小文字を区別：選択すると、検索結果は検索ターゲットの大文字・小文字に一致します。
検索範囲（プロジェクト、モジュール、ディレクトリ、カスタムスコープ）を指定します。
検索をクリックしてください。
PhpStorm は検索ツールウィンドウに結果を表示します。
新しい検索テンプレートインスペクションを構造検索にカスタムテンプレートとして追加できます。これを行うには、検索ツールウィンドウでテンプレートからインスペクションを作成するをクリックします。その後、このテンプレートを再利用してコードをインスペクションできます。

ターゲットを構造的に置き換える

メインメニューで編集 | 検索 | 構造置換へ移動します。
構造置換ダイアログで、新規または既存のテンプレートを検索に追加し、テンプレート領域を置き換えます。置換テンプレートは、検索テンプレートと同じ方法で保存できます。
置換テンプレート内の変数にフィルターを追加する場合は、目的の変数にキャレットを置き、フィルター領域でフィルターを管理します。
フィルター領域では、あなたのように選択した内容に応じて、フィルター条件を指定してください。
置換結果を絞り込むには、次のオプションを選択します：
- 修飾名を短縮する - 完全修飾クラス名を短縮名およびインポートに置き換えます。
- 整形 - 置き換えられたコードを自動的にフォーマットします。
- 静的インポートを使用する - 可能であれば、静的インポートを代わりに使用します。
必要なオプションを指定したら、検索をクリックします。 PhpStorm は検索ツールウィンドウに結果を表示します。
検索ツールウィンドウでは、結果をさらに操作して、見つかったアイテムを 1 つずつ、または一度にすべて置き換えたり、潜在的な変更をプレビューしたりできます。

検索テンプレートを共有する

検索テンプレートはエクスポートまたはインポートによって仲間と共有できます。

構造検索ダイアログ（編集 | 検索 | 構造検索）で、新しい検索テンプレートを作成するか、既存のテンプレートを使用します。
テンプレートをエクスポートするには、をクリックします。 PhpStorm はテンプレートの XML 表現をクリップボードに追加します（内容を見るには Ctrl+Shift+V を押します）。この表現は、チャット、メール、フォーラムで他の開発者と共有できます。
テンプレートをインポートするには、共有 XML コードを任意の場所（メール、チャット、フォーラム）からコピー（Ctrl+C ）し、構造検索ダイアログでをクリックします。 PhpStorm は XML コード表現を取得し、変数やスコープが存在すればそれを含めてテンプレートに変換します。

2026 年 5 月 22 日