PHP Webページデバッグ設定によるデバッグ

デバッグエンジンの準備

デバッグを開始する前に、デバッグエンジンが正しくインストールされ、正しく構成されていることを確認してください。PhpStormは、2つの最も一般的なツール、Xdebug(英語)とZend デバッガー(英語)でデバッグをサポートしています。これらのツールは、互いにブロックするため同時に使用することはできません。この問題を回避するには、Xdebugの設定およびZend デバッガーの設定の説明に従って、php.ini ファイルの対応するセクションを更新する必要があります。

エディターでアクティブな php.ini ファイルを開くには：

1. 設定/環境設定ダイアログ（Ctrl+Alt+S）で、 言語 & フレームワークのPHPをクリックします。

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

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

ブレークポイントの設定

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

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

   ブレークポイントは、php , html内のPHPコンテキストおよび他の種類のファイルに設定できます。行ブレークポイントは実行可能な行にのみ設定できますが、コメント、宣言、または空行には設定できません。

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

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

   • メインメニューから実行 | 行ブレークポイントの切り替えを選択します。

   • Ctrl+F8を押します。

PHP Webページタイプのデバッグ設定の作成

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

   • メインメニューで実行 | 構成の編集を選択します。

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

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

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

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

5. 「開始 URL」フィールドに、アプリケーション開始ページを実装するファイルへのサーバーパスを入力します。サーバー構成ルートからの相対パスを指定します（ サーバー構成ルートは、サーバー構成からアクセス可能なローカルまたはリモートサーバー上のファイルツリー内の最上位フォルダーです。in-placeサーバーの場合はプロジェクトルートです）。下の読み取り専用フィールドは、アプリケーションの開始ページのURLアドレスを示しています。URLアドレスは入力したとおりに動的に構成されます。

6. アプリケーションを開くブラウザを指定します。ブラウザーリストから設定済みのブラウザを選択するか、参照 をクリックして、表示されるWeb ブラウザーダイアログで別のブラウザを指定します。

デバッグセッションの開始と停止されたプログラムの検査

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に通知するには、スキップされたパスについて通知するチェックボックスをオンにします。