PhpStorm 2026.3 Help

PHP Web ページのデバッグ構成でデバッグする

このデバッグモードでは、PhpStorm がデバッグプロセスを完全に制御します。つまり、 PHP Web Page デバッグ構成に従って、アプリケーションを起動し、ブラウザーを開き、デバッグエンジンを有効にします。

PHP Web ページデバッグ構成は、アプリケーションの開始ページにアクセスするための URL アドレス、開始ページを開くブラウザー、使用する デバッグサーバー構成を PhpStorm に指示します。

デバッグ中に PhpStorm が無視するスクリプトリクエストを指定することもできます。 この方法は、アプリケーションに AJAX を使用するスクリプトが含まれている場合に役立ちます。 Web ページの一部を「再ロード」する menu-ajax-script.php があるとします。 このスクリプトは正しく動作するため、デバッグする必要はありません。 ただし、このスクリプトはデバッグセッション中にも要求されます。 このスクリプトへの受信接続を無視するには、 menu-ajax-script.php スクリプトを スキップされたパスのリストに追加します。

デバッグエンジンを準備する

PhpStorm は、最も人気のある 2 つのツール、 Xdebug(英語) と Zend デバッガー(英語)によるデバッグをサポートしています。 これらのツールは、互いにブロックし合うため、同時に使用することはできません。 この問題を回避するには、 Xdebug を構成する および Zend デバッガーの構成 に従って、関連する PHP インタープリターの php.ini ファイルを更新する必要があります。

エディターでアクティブな php.ini ファイルを開きます:

  1. 設定 ダイアログ (Ctrl+Alt+S) で、 PHP をクリックします。

  2. 表示される PHP ページで、 CLI インタープリター フィールドの横にある 参照ボタン をクリックします。

  3. 開いている CLI インタープリター ダイアログで、 構成ファイル 読み取り専用フィールドにアクティブな php.ini ファイルへのパスが表示されます。 Open in Editor をクリックします。

ブレークポイントの設定

ブレークポイントは 、デバッグセッション中にアクションをトリガーするために使用されるソースコードマーカーです。 通常、ブレークポイントを設定する目的は、プログラムの実行を一時停止して、プログラムデータを調査できるようにすることです。 ただし、PhpStorm は、さまざまなアクションのトリガーとしてブレークポイントを使用できます。 ブレークポイントは、デバッグプロセス中にいつでも設定できます。 ブレークポイントはソースファイルに直接影響しませんが、ブレークポイントとその設定は PhpStorm プロジェクトとともに保存されるため、デバッグセッション間で再利用できます。

  1. キャレットをソースコードの目的の行に配置します。

    ブレークポイントは、 php 、 html 、その他のタイプのファイル内の PHP コンテキストで設定できます。 行ブレークポイントは、実行可能行にのみ設定できますが、コメント、宣言、空の行には設定できません。

  2. 以下のいずれか 1 つを実行します:

    • ブレークポイントを切り替えるラインのガター領域をクリックします。

    • 実行 | 行ブレークポイントの切り替え に進みます。

    • Ctrl+F8 を押す。

PHP Web ページのデバッグ構成を作成する

  1. 次のいずれかを実行して 実行 / デバッグ構成ダイアログを開きます。

    • 実行 | 実行構成の編集 に進みます。

    • Alt+Shift+F10 を押してから 0 を押して 構成の編集 ダイアログを表示するか、ポップアップから構成を選択して F4 を押します。

  2. ツールバーの 追加ボタン をクリックするか、 Insert を押します。 リストから PHP Web ページ 構成タイプを選択します。 PHP Web ページダイアログが開きます。

  3. 構成名を指定します。

  4. Server リストから適切なデバッグサーバー構成を選択するか、 参照 参照ボタン をクリックします。 PHP デバッグサーバー構成を作成する 説明に従って開く サーバーダイアログでデバッグサーバー設定を定義します。

  5. 開始 URL フィールドに、アプリケーションの開始ページを実装するファイルへのサーバーパスを入力します。 サーバー構成ルートを基準としたパスを指定します (サーバー構成ルートは、サーバー構成を通じてアクセスできる ローカルまたは リモートのサーバー上のファイルツリー内で最上位のフォルダーです。 インプレースサーバーの場合は、プロジェクトルートです)。 )。 下の読み取り専用フィールドには、アプリケーション開始ページの URL アドレスが表示されます。 入力に合わせて URL アドレスが動的に構成されます。

  6. アプリケーションを開くブラウザーを指定します。 ブラウザー リストから構成済みブラウザーを選択するか、 参照 参照ボタン をクリックして、開いた ウェブブラウザーとプレビュー ダイアログで 別のブラウザーを指定します。

デバッグセッションを開始し、中断されたプログラムを調べる

  1. デバッグを開始するには、ツールバーの デバッグ ボタン the Debug button をクリックします。

  2. デバッガーが最初のブレークポイントに到達して一時停止したら、 フレームを分析してアプリケーションを調べます。 フレームはアクティブなメソッドまたは関数の呼び出しに対応し、呼び出されたメソッドまたは関数のローカル変数、その引数、式の評価を可能にするコードコンテキストを格納します。 現在アクティブなフレームはすべて デバッグツールウィンドウの フレーム ペインに表示され、フレームを切り替えて、そこに保存されている情報を 変数 および ウォッチ ペインで分析できます。 詳細については、「中断されたプログラムを調べる 」セクションを参照してください。

  3. プログラムの実行を継続し、再び中断されるとすぐにそのフレームを調べます。

    • プログラムの実行を手動で制御するには、 実行 メニューまたはツールバーボタンのコマンド(ステップイン   F7、 ステップアウト   Shift+F8、 ステップオーバー   F8 など)を使用してコードをステップ実行します。 詳細については、 プログラムのステップスルー を参照してください。

    • プログラムを自動的に次のブレークポイントまで実行させるには、 実行 | デバッグアクション | 再開 を選択するか F9 を押してセッションを再開します。

リクエストをスキップするスクリプトを指定

この方法は、アプリケーションに AJAX を使用するスクリプトが含まれている場合に役立ちます。 Web ページの一部を「再ロード」する menu-ajax-script.php があるとします。 このスクリプトは正しく動作するため、デバッグする必要はありません。 ただし、このスクリプトはデバッグセッション中にも要求されます。 このスクリプトへの受信接続を無視するには、 menu-ajax-script.php スクリプトを スキップされたパスのリストに追加します。

  1. 設定 ダイアログ(Ctrl+Alt+S )で PHP | デバッグ | スキップするパス に移動します。

  2. PhpStorm が受信接続を受信した場合、呼び出されないスクリプトを含むスクリプトとフォルダーの「無視リスト」を開き、 スキップするパス ページを開きます。

    • リストに新しいエントリを追加するには、 追加ボタン をクリックするか Alt+Insert を押します。 次に 参照ボタン をクリックして表示されるダイアログで、接続をスキップするファイルまたはフォルダーを選択します。

    • リストからエントリを削除するには、それを選択して the Remove button をクリックするか Alt+Delete を押します。 スクリプトはリクエストを受け取ると実行されます。

  3. スキップするスクリプトへのリクエストを受け取るたびに PhpStorm に通知するには、 スキップされたパスについて通知する チェックボックスをオンにします。

2026 年 11 月 9 日