PhpStorm 2025.2 ヘルプ

ゼロコンフィギュレーションデバッグ

ゼロコンフィギュレーションデバッグの場合、デバッグ構成を作成する必要はありません。代わりに、PHP アプリケーションの開始ページをブラウザーで手動で開き、ブラウザーからデバッグエンジンをアクティブにし、PhpStorm は受信デバッガー接続を待機します。

デバッグセッションを開始する

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

ゼロ構成デバッグセッションを開始するには、次の一般的な手順を実行します。

デバッグエンジンのインストールを検証する

  • 以下のいずれかを行います。

    • コマンドラインで、php --version コマンドを実行します。出力には、インストールされている拡張機能の中にデバッグエンジンが表示されます。

      Xdebug extension installed
      Zend debugger extension installed
    • phpinfo(); 関数呼び出しを含む php ファイルを作成します。次にこのファイルをブラウザーで開きます。phpinfo の出力には、デバッグエンジンのセクションが含まれているはずです。

      Debugging engine installed
      Debugging engine installed

受信デバッグ接続のリッスンを有効にする

  • PhpStorm ツールバーまたはステータスバーの PHP のデバッグ接続を聞く開始ボタン start listening php debug connections を切り替えて、stop listening php debug connections に変更します。その後、PhpStorm は現在のプロジェクトで使用されているデバッグエンジンのポートのリッスンを開始します。デバッグポートは、設定ダイアログ (Ctrl+Alt+S) の PHP | デバッグページの PhpStorm レベルで設定されます。Start listening to debugging connections

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

次のいずれかを実行して、コードにブレークポイントを設定します。

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

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

  • Ctrl+F8 を押します。

Set breakpoints

または、PhpStorm との接続が確立されるとすぐにデバッガーを停止させるには、実行 | PHP スクリプトの最初の行で中断するを選択します(最初のブレークポイントに達するまで自動的に実行するのではなく)。

サーバー上でデバッガーを有効にする

サーバー上でデバッガーエンジンをアクティブ化するには、次のいずれかを実行します。

  • 特別な GET/POST または COOKIE パラメーターを手動で設定します (詳細については、Xdebug(英語) の公式ドキュメントを参照してください)。

  • ブラウザー拡張機能を使用すると、1 回のクリックでデバッガーを有効にできます。例: Chrome の場合は、JetBrains による Xdebug ヘルパー(英語)拡張機能を使用できます。

    Xdebug helper in Chrome

デバッグセッションを開始する

  1. ブラウザーでページを再読み込みし、PhpStorm に戻ります。<デバッグエンジン> からの受信接続ダイアログでパスマッピングを選択し、PhpStorm が Web サーバー上のリモートファイルをプロジェクト内のローカルファイルにマップできるようにします。デプロイ構成が定義されている場合、PhpStorm では、その構成ですでに設定されているパスに基づいてマッピングを構成することができます。

    Incoming debugger connection Xdebug

    このステップでは、プロジェクトレベルでデバッグ接続のリスニングを無効にすることもできることに注意してください。これは、複数のプロジェクトを開いて受信接続をリッスンしている場合に便利です。

  2. ブレークポイントに到達すると、デバッガーは一時停止されます。これで、PhpStorm のデバッグツールウィンドウでアプリケーションを調査できます。

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

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

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

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

デバッグ中に PhpStorm が無視するスクリプトリクエストを指定することもできます。この方法は、アプリケーションに 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 に通知するには、スキップされたパスについて通知するチェックボックスをオンにします。

2025 年 3 月 26 日

関連ページ:

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 インタープリターの統合を有効にするエ...

デバッグエンジンの構成を検証する

PhpStorm は、ローカルまたはリモート Web サーバー上の Xdebug の構成を検証し、不足している設定や他の設定と矛盾している設定を検出し、矛盾点を説明して修正を提案します。ダイアログには、検証の実行方法と場所に応じていくつかのオプションが用意されています。出力 phpinfo()。PhpStorm は、CLI コマンドまたはからレンダリングされた Web ページから手動でコピーして貼り付けた出力を解析します。ローカル Web サーバーまたは共有フォルダー。PhpStorm は、ローカル...

デバッグ

このページを使用して、Xdebug と Zend デバッガーの動作を設定します。事前構成この領域には、デバッガーのインストール、デバッガーのクッキーを制御してデバッグセッションを開始 / 停止するを実行するブックマークレットの生成、およびゼロコンフィギュレーションデバッグの起動に関する簡単なガイドラインが示されています。外部接続この領域で、PhpStorm がホストから受信した接続、デプロイサーバー構成として登録されていないポートを介した接続をどのように処理するかを指定します。未登録のサーバー構...

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PhpSto

デバッグツールウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが開きます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ (フレーム、変数など) を表示および分析し、デバッガーアクションを実行します。デフォルトでは、プログラムがブレークポイントに到達したときにデバッグツールウィンドウが開き、セッションが終了しても非表示になりません。この動作を変更するには、ビルド、実行、デプロイ | デバッガー設定ページに移動し、ブレークポイントでデバッグウィンドウを表示するチェックボック...