PhpStorm 2020.2ヘルプ

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

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

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

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

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

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

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

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

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

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

ブレークポイントを設定する

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

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

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

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

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

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

    • Ctrl+F8を押します。

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

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

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

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

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

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

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

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

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

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

  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がそれらへの受信接続を受信した場合に呼び出されないスクリプトを含むフォルダーのセット。

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

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

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

最終更新日: 2020年7月15日

関連ページ:

Xdebugを構成する

XdebugをダウンロードPHPのバージョンと互換性のあるXdebug拡張をダウンロードし、インストールガイドの説明に従ってインストールします。AMPパッケージを使用している場合、Xdebug拡張機能が既にインストールされている可能性があります。パッケージに固有の手順を参照してください。Xdebug...

Zendデバッガーの構成

Zend デバッガーをダウンロードしてインストールするお使いのオペレーティングシステムに対応したZend デバッガーパッケージをダウンロードしてください。PHPのバージョンに対応するディレクトリ(ZendDebugger.soなど)でZendDebugger.dll(UNIX)またはphp-7.0....

PHP

The page and all the pages under this node are available only when thePHPplugin is enabled. Theplugin is activated by default. If the plugin is disabl...

実行/デバッグ構成ダイアログ

実行 | 構成の編集このダイアログを使用して、実行/デバッグ構成を作成、編集、調整、または削除したり、新しく作成されたすべての実行/デバッグ構成に適用されるデフォルトのテンプレートを構成したりします。プロジェクト構成は構成タイプによってグループ化されています。デフォルトの構成テンプレートは、ダイアロ...

PHPデバッグサーバー構成を作成する

PHPデバッグサーバーの設定という用語は、デバッグエンジンがローカルおよびリモート Webサーバーと対話し、サーバー上のファイルとPhpStormプロジェクト内のローカルコピーとの間の対応を設定するHTTPアクセスを確実にする設定を示します。デバッグサーバー設定の設定は、PHP Web ページまたは...

ブラウザーの構成

PhpStormには、HTMLファイルの出力の実行、デバッグ、またはプレビュー中にIDEから自動的にインストールおよび起動できる最も一般的なブラウザの事前定義リストが付属しています。PhpStormは、標準の手順に従ってブラウザをインストールすることを前提としており、各インストールに、ブラウザの実行...