インスペクションを実行する
PhpStorm は、エディターで開かれたファイル内の コードを分析し 、入力時に問題のあるコードをハイライトします。 さらに、選択したファイル範囲に対して必要なインスペクションまたは一連のインスペクションを 手動で実行できます。 この場合、ファイル内で検出されたすべての問題に関する包括的なレポートが得られます。
現在のファイルの即時分析
IDE は継続的にコードをチェックし、問題を検索します。 PhpStorm がコードを分析する際、現在選択されている インスペクションプロファイルで定義されたインスペクションを使用します。 エディターの右上隅にあるウィジェットには、現在のファイルで検出された 各重大度の問題の数が表示されます。
ウィジェットをクリックすると、 問題ツールウィンドウの ファイル タブで問題のリストが開きます。 を選択するか、 Alt+6 を押して、 問題 ツールウィンドウにアクセスすることもできます。
各問題について、 Alt+Enter を押すか、 
をクリックすると、提案されたクイックフィックスが表示されます。 エディターの対応する行に移動するには、 F4 を押すか、ツールウィンドウで問題をダブルクリックします。
をクリックすると、ツールウィンドウで問題を表示して修正できるようになります。
スクロールバーのカラーストライプは、検出されたコードの問題を示し、ファイルをスクロールせずに対応する行にすばやくアクセスできます。 ストライプ上のマークにカーソルを合わせると、ツールチップで検出された問題が表示されます。 マークをクリックすると、対応する行に移動します。
検出された問題に移動する
ウィジェットで 
をクリックするか、それに応じて F2 または Shift+F2 を押すと、ファイル内でハイライトされた問題から別の問題に移動できます。 デフォルトでは、IDE は 重大度に応じて問題に移動します: エラー> 警告> 弱い警告> サーバーの問題> タイプミス。
重大度に関係なく、問題を 1 つずつ解決するように PhpStorm を構成できます。 エディターの右上隅にあるウィジェットの上にマウスを置き、 
をクリックし、 '次のエラー' アクション (F2) 実行 を選択して、 すべての問題 を有効にします。
インスペクションを手動で実行する
いくつかのインスペクションはグローバルコード分析を必要とし、それらがエディターで無効にされる理由です。 これらのインスペクションは にリストされています。 
をクリックして バッチモードのインスペクションのみを表示する を選択します。
コード内のすべての問題の完全なレポートを取得するには、インスペクションを手動で実行します。 この場合、IDE は インスペクションプロファイル で有効になっているすべてのインスペクションを実行し、専用のツールウィンドウに結果を表示します。 分析を完了するのに必要な時間は、有効になっているインスペクションの数と分析するスコープのサイズによって異なります。
すべて実行インスペクション
メインメニューで へ移動します。
分析するファイルの 範囲を選択します。
アイコンをクリックして、新しいスコープを構成します。適用するインスペクションプロファイルを選択します。
新しいプロファイルを作成するか、既存のプロファイルの 1 つを変更するには、 構成… をクリックします。
分析 をクリックして解析を開始します。
インスペクションスコープの指定ダイアログ
項目 | 説明 |
|---|---|
プロジェクト全体 | プロジェクト全体の検査。 |
モジュール <name> | Project ツールウィンドウ（Alt+1 ）で現在選択されているモジュールをインスペクションします。 |
ファイル <name> | Project ツールウィンドウで現在選択されているか、エディターで開かれているファイルを調べます。 |
選択したファイル | Project ツールウィンドウで現在選択されているファイルを調べます。 |
未コミットのファイル | このスコープは、バージョン管理下のプロジェクトでのみ使用できます。 バージョン管理システムにコミットされていないファイルのみをインスペクションします。 |
Directory | Project ツールウィンドウで現在選択されているディレクトリを調べます。 |
カスタムスコープ | ファイルのカスタムスコープをインスペクションします。 リストから定義済みのスコープを選択するか、 |
テストソースを含める | 分析範囲に含まれるテストソースを調べます。 |
注入されたコードを検査する | コードに埋め込まれた 他の言語のコードをインスペクションします。 |
インスペクションプロファイル: | コードのインスペクションに使用する プロファイルを選択します。 必要なプロファイルがリストにない場合は、 構成 をクリックして新しいプロファイルを作成します。 |
シングルインスペクションを実行
単一のインスペクションを実行すると、特定の問題を追跡する場合に役立ちます。 ファイル内で警告が見つかった場合は、プロジェクト全体またはファイルの必要な範囲をインスペクションして、コードベースにそのような警告がないことを確認できます。
Ctrl+Alt+Shift+I を押すか、メインメニューで に移動します。
ポップアップにインスペクション名を入力します。 キャメルハンプを使用して、キャメルケースの単語と空白を単語の最初の文字と一致させます。 候補リストには、検索要求に一致するインスペクションが表示されます。
正しいインスペクションを選択しているかどうかわからない場合は、その説明を表示できます。 これを行うには、ポップアップでインスペクションを選択し、 Ctrl+Q を押します。
必要なインスペクションをダブルクリックします。
表示されるダイアログで、分析するファイルの範囲を選択します。
必要に応じて、 ファイルマスク チェックボックスを有効化します。 ファイルマスク オプションを使用すると、処理するファイルを絞り込むことができます。 含めるファイルに一致するように、ワイルドカードを使用して 1 つ以上のファイル名パターンを指定します。 複数のファイルマスクはコンマで区切ります。 詳しくは 特定のファイルタイプで検索する を参照してください。
一部のインスペクションには、設定を求めるプロンプトが表示される追加オプションがあります。
これらの設定はこの実行にのみ適用され、現在のプロファイルのこのインスペクションの構成には影響しません。
IDE は、インスペクションの結果を専用のツールウィンドウツールウィンドウに表示します。 そこで、検出された問題を調べて修正できます。
コミット時にコードを分析する
プロジェクトが Git または Mercurial バージョン管理下にある場合は、変更されたファイルをコミットする前に分析するように IDE を構成できます。
Alt+0 を押して コミット ツールウィンドウを開き、 Show Commit Options
をクリックします。コミットチェック 領域で、 コードの解析 チェックボックスを選択します。
プロファイルの選択 をクリックし、IDE がインスペクションを実行するために必要な インスペクションプロファイルを選択します。
コミット をクリックします。
IntelliJ IDEA は、選択したプロファイルからインスペクションを実行することにより、変更されたファイルのコードを分析します。
エラーまたは警告が検出されると、通知が表示されます。
通知で、 コード解析のレビュー をクリックして、 メッセージ ツールウィンドウで検出された問題のリストを表示します。 無視 をクリックして、検出された問題を修正せずに変更をコミットします。
コードインスペクションを Qodana で実行する
この機能は Qodana(英語) プラグインに依存しており、PhpStorm にはデフォルトでバンドルされ有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。 詳細については、 個別のファイルを適用するを参照してください。
Qodana を使用して、コードをローカルまたはリモートでインスペクションできます。 Qodana の主な使用例は、CI/CD サーバー上でリソースを大量に消費するコード分析をリモートで実行することです。 ただし、IDE で同じ分析を実行して、同じ結果が得られることを確認し、ソースコード内で検出された問題を特定することもできます。
メインメニューで へ移動します。
インスペクションを実行する場所 (ローカルまたは CI/CD サーバー) を選択します。
サーバー上でインスペクションを実行するには、まず CI 上で Qodana をセットアップする必要があります。
Qodana 設定ファイルが開きます。 このファイルでは、Qodana インスペクションプロファイルを指定し、特定のインスペクションを有効または無効にし、分析前にインストールする必要があるプラグインのリストを指定できます。
実行 をクリックします。
分析が完了すると、 Qodana タブの 問題 ツールウィンドウにレポートが表示されます。 結果をローカルで操作することも、 Qodana クラウド(英語)に送信することもできます。
Qodana 分析のすべてのローカル実行のレポートは保存され、メインメニュー から利用できます。 現在開いているレポートの横にはチェックマークが付いており、それをクリックしてレポートを閉じることができます。
Qodana の詳細については、その ドキュメントを参照してください。
インスペクションをオフラインで実行する
IDE からコードインスペクションを実行することに加えて、実際に PhpStorm を実行せずにコマンドラインからインスペクションを起動することができます。 インスペクションの結果は XML ファイルに保存されます。 詳細は、 Karma を参照してください。
スコープの順序を変更する
デフォルトでは、すべての有効なコードインスペクションがプロジェクト内のすべてのファイルを解析します。 必要に応じて、同じインスペクションを異なる設定のファイルの複数のスコープで実行することができます。
ファイルが複数のスコープに含まれていて、これらのスコープでインスペクションを有効にすると、PhpStorm はリスト内の順序に基づいて処理します。 一番上のスコープは優先順位が最も高く、最初に分析されます。
設定 ダイアログ (Ctrl+Alt+S) で、 を選択します。
リストから任意のインスペクションを選択します。
すべてのスコープ リストから スコープ順序の編集 を選択してください。
必要な範囲を選択し、
と 
を使ってリストを上下に移動します。
必要に応じて、新しいスコープを作成します。 これを行うには、
(スコープの編集…) をクリックし、スコープ設定を指定し、スコープ設定に含めるファイルとフォルダーを選択します。 詳細については、「Web サーバーに接続する 」を参照してください。