PhpStorm 2026.3 Help

Xdebug プロキシを介したマルチユーザーデバッグ

デバッグセッションを開始すると、Xdebug 拡張機能は PhpStorm が実行されている IP アドレスに接続し、 xdebug.remote_host （Xdebug 2 の場合）または xdebug.client_host （Xdebug 3 の場合）の値として指定されます。 PhpStorm はこの接続を受け入れ、それを介して Xdebug と通信できます。 Xdebug は、単一の IP アドレスへの接続のみをサポートし、セキュリティ上の理由から、ブラウザーを実行している IP アドレスに自動的に接続し直すことはありません。 マルチユーザー環境(英語)で PHP アプリケーションをデバッグするために、Xdebug はいわゆる DBGp プロキシ(英語)を提供します。

プロキシを使用すると、PHP Xdebug 拡張機能は PhpStorm に直接接続するのではなく、代わりに DBGp プロキシサーバーに接続します。 その後、チーム内のすべての開発者がそのプロキシに接続します。 各開発者は、このプロキシを介して実行される個別のデバッグセッションを持ち、同じサーバー上で同じコードのマルチユーザーデバッグを行うことができます。

PS Xdebug スキーマプロキシ

Xdebug プロキシ（DBGp）サーバーを介したマルチユーザーデバッグの構成

DBGp プロキシをダウンロードしてインストールする

デバッグセッションを開始できるようにするには、Web サーバー自体とすべての開発者マシンからアクセスできるサーバー上で DBGp プロキシを実行する必要があります。 Web サーバー、同じネットワーク内のマシン、SSH トンネル経由でアクセス可能なマシンにプロキシをインストールできます。

  1. プラットフォーム用の dbgpProxy 実行可能ファイルを DBGp プロキシツールのダウンロードページ(英語)にダウンロードします。

  2. Web サーバー、または Web サーバーとすべての開発者マシンの両方と通信できるマシンで DBGp プロキシを開始します。 DBGp プロキシ実行可能ファイルは、2 つの主要な引数を受け入れます。

    • -i: IDE（クライアント）接続をリッスンするホストとポート

    • -s: デバッガーエンジン（サーバー）接続をリッスンするホストとポート

    詳細は、 DBGp プロキシツールのドキュメント(英語)を参照してください。

    次の例では、ループバックアドレス 127.0.0.1 とポート 9001 でデバッガー接続をリッスンするプロキシを起動し、マシンの IP アドレスとポート 9000 で開発者をリッスンします。

    dbgpProxy.exe -i 192.168.1.11:9000 -s 127.0.0.1:9001
    ./dbgpProxy-macos -i 192.168.1.11:9000 -s 127.0.0.1:9001
    ./dbgpProxy -i 192.168.1.11:9000 -s 127.0.0.1:9001

    DBGp プロキシは、起動時にこれらの設定を確認します:

    Ps Pdgp Running

Xdebug が Web サーバーにインストールされ、構成されていることを確認する

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

    1. 設定 ダイアログ (Ctrl+Alt+S) で、 PHP をクリックします。

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

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

  2. 少なくとも次の設定が指定されていることを確認してください。

    [xdebug] zend_extension="<path to xdebug extension>" xdebug.mode=debug xdebug.client_host=127.0.0.1 xdebug.client_port="<the port (9003 by default) to which Xdebug connects>"
    [xdebug] zend_extension="<path to xdebug extension>" xdebug.remote_enable=1 xdebug.remote_host=dbgp_proxy_hostname_or_ip xdebug.remote_port="<the port (9000 by default) to which Xdebug connects>"

Xdebug の構成の詳細については、「Xdebug を構成する 」を参照してください。

PhpStorm から DBGp プロキシサーバーへのアクセスを構成する

  1. メインメニューから ツール | DBGp プロキシ | IDE の登録 を選択します。

  2. 表示される DBGp プロキシダイアログでは、 IDE キー の値（デバッグセッションを識別するための各開発者の一意の値）、Xdebug プロキシサーバーのホストとポートを指定します。

    Pdgp 登録 Ide

  3. 指定したプロキシサーバーに接続するには、 OK をクリックします。 サーバーは資格情報を登録し、接続を確認します。

    Pdgp Register Ide Connected

    PhpStorm は正常な接続についても通知します。

    Pdgp 登録 Ide が成功しました

  4. 既存の資格情報を更新するには、メインメニューで ツール | DBGp プロキシ | 構成 を選択します。 表示される DBGp プロキシダイアログで、IDE キー、ホスト、ポート設定を編集します。

    現在の資格情報を破棄するには、メインメニューの ツール | DBGp プロキシ | IDE 登録のキャンセル を選択します。

ブラウザーでデバッグセッションを開始する

  1. 使用している ブラウザーのデバッグ拡張機能 が、登録済みの IDE キーに設定されていることを確認します。

    Pdgp Ide キー

  2. PhpStorm では、次のいずれかを実行して、受信デバッグ接続のリッスンを有効にします。

    • ツールバー / ステータスバーの the Start Listening for PHP Debug Connections button をクリックします。

    • メインメニューで 実行 | PHP デバッグ接続のリッスンを開始 を選択します。

    これにより、Web サーバーでデバッグセッションが開始されると PhpStorm が反応し、 デバッグツールウィンドウが自動的に開きます。 デバッグセッションを開始する前に、 ブレークポイントが設定されているか、 設定 ダイアログ Ctrl+Alt+S の デバッグ ページで PHP スクリプトの最初の行で中断する オプションが有効になっていることを確認してください。

    ブラウザーでページをリフレッシュしてデバッグセッションを開始します。

    Pdgp デバッグ開始

トラブルシューティング

リモートファイルパスがプロジェクト内のファイルパスにマップされていません

場合によってはデバッガーに接続できますが、リモートとプロジェクトファイル間のマッピングが定義されていないことを示すエラーメッセージが表示されます。 これは、PhpStorm が、デバッグ中のファイルに対応するローカルファイルを判別できないことを意味します。

マッピングが構成されていません

この問題は、 クリックしてパスマッピングを設定する をクリックして、必要なパスマッピングを提供することで解決できます。 さらに、 Web サーバーに接続するで概説されている手法を使用して、これらのマッピングを構成できます。

ターゲットマシンが積極的にそれを拒否したため、接続できませんでした

  • PhpStorm が DBGp プロキシに登録されており、 受信デバッガー接続をリッスンしていることを確認してください。

  • PhpStorm および デバッガーのブックマークレットまたはブラウザー拡張機能で 正しい IDE キーが設定されていることを確認してください。

  • DBGp プロキシへの接続をブロックしているファイアウォールはありますか？ その場合は、PHP Xdebug 拡張機能と開発者のマシンが接続できることを確認してください。 You can use http://canyouseeme.org or a similar service to check for opened inbound ports.

  • IDE への接続をブロックしているファイアウォールはありますか？ DBGp プロキシマシンから PhpStorm に接続できることを確認してください。 You can use http://canyouseeme.org or a similar service to check for opened inbound ports.

  • DBGp プロキシアプリケーションが間違った IP アドレスにバインドします。 アドレスとして 0.0.0.0 を使用して実行すると、DBGp プロキシサーバー上の任意の IP アドレスにバインドされます。 例: dbgpproxy -i 0.0.0.0:9001 -s 0.0.0.0:9000 を実行します。

同じマシンに Xdebug と DBGp プロキシをインストールした状態で、PhpStorm でマルチユーザデバッグをテストする場合、検証する必要があるものがいくつかあります。

  • PhpStorm は間違った IP アドレスにバインドします。 PhpStorm も実行されているローカルマシンで DBGp プロキシを実行すると、IDE が間違ったネットワークサブネットを使用している可能性があります。 これを修正するには、メインメニューで ツール | DBGp プロキシ | 構成 ... を選択し、DBGp プロキシサーバーの IP アドレスを 0.0.0.0 に設定します。 次に、PhpStorm を DBGp プロキシに再登録してみてください。

  • ポートの競合が存在します。 ローカルマシンで DBGp をテストする場合、PhpStorm と DBGp の両方が同じポートにバインドする場合があります。 別のポートを使用するように DBGp を構成するか、 設定 ダイアログ Ctrl+Alt+S の PHP | デバッグ ページで PhpStorm の Xdebug ポートを変更することにより、そうではないことを確認してください。

2026 年 11 月 9 日
PHP と JavaScript コードを同時にデバッグする中断されたプログラムを調べる