PhpStorm 2025.1 ヘルプ

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

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

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

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

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

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

関連ページ:

Xdebug を構成する

Xdebug をダウンロード PHP バージョンと互換性のある Xdebug 拡張をダウンロードし、Xdebug インストールガイドの説明に従ってインストールします。事前構成された AMP (Apache、MySQL、PHP) パッケージを使用している場合は、Xdebug 拡張機能がすでにインストールされている可能性があります。パッケージに固有の手順を参照してください。Xdebug と PHP エンジンの統合アクティブな php.ini ファイルをエディターで開きます。デバッグエンジンが PhpStor...

Zend デバッガーの構成

Zend デバッガーをダウンロードしてインストールするお使いのオペレーティングシステムに対応した Zend デバッガーパッケージをダウンロードしてください。PHP のバージョンに対応するディレクトリ(php-7.0.x など)で ZendDebugger.so(UNIX) または ZendDebugger.dll(Windows) ファイルを見つけます。Web サーバーからアクセス可能な場所に Web サーバーにファイルをコピーします。Zend デバッガーと PHP インタープリターの統合を有効にするエ...

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

このダイアログを使用して、実行 / デバッグ構成を作成、編集、調整、削除したり、新しく作成されたすべての実行 / デバッグ構成に適用されるデフォルトのテンプレートを構成したりします。既存の実行 / デバッグ構成は、構成タイプごとにグループ化されています。新しい構成を作成するためのテンプレートは編集可能であり、ダイアログの左側のペインにある構成テンプレートの編集リンクから利用できます。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名...

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

PHP デバッグサーバーの設定という用語は、デバッグエンジンがローカルサーバーおよびリモート Web サーバーと対話し、サーバー上のファイルと PhpStorm プロジェクト内のローカルコピー間の対応を設定するために HTTP アクセスを確保する設定を示します。デバッグサーバー構成の設定は、PHP Web ページまたは PHP リモートデバッグタイプの実行 / デバッグ構成を使用してデバッグする場合、およびゼロ構成デバッグセッション中に使用されます。デバッグサーバー構成を最初から手動で作成すること...

ウェブブラウザーとプレビュー

このページでは、次を構成できます。Web ブラウザーのインストールを PhpStorm と統合し、PhpStorm からの Web ブラウザーの起動をアクティブ化または非アクティブ化します。実行可能ファイルを実行するか、デフォルトのシステムコマンドを使用してブラウザーを起動するかどうかを指定します。デフォルトで PhpStorm が要求に応じて HTML ファイルを開くデフォルトの PhpStorm ブラウザーを指定します。つまり、ブラウザーが明示的に指定されていない場合、ブラウザーで HTML...

ブラウザー

PhpStorm には、HTML ファイルの出力の実行、デバッグ、プレビュー中に IDE から自動的にインストールおよび起動できる最も一般的なブラウザーの事前定義リストが付属しています。PhpStorm は、標準の手順に従ってブラウザーをインストールすることを前提としており、各インストールに、ブラウザーの実行可能ファイルまたは macOS アプリケーションへのデフォルトパスを表すエイリアスを割り当てます。デフォルトリストのブラウザーに加えて、カスタムブラウザーのインストールを設定できます。Php...