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

ブレークポイントの設定

ブレークポイントは、デバッグセッション中にアクションをトリガーするために使用されるソースコードマーカーです。通常、ブレークポイントを設定する目的は、プログラムの実行を一時停止して、プログラムデータを調査できるようにすることです。ただし、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. サーバーリストから適切なデバッグサーバー構成を選択するか、参照 をクリックします。PHP デバッグサーバー構成を作成する説明に従って開くサーバーダイアログでデバッグサーバー設定を定義します。

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

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

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

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

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 を押します。次に をクリックして表示されるダイアログで、接続をスキップするファイルまたはフォルダーを選択します。

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

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