PhpStorm 2026.3 Help

Zend デバッガーの構成

Zend デバッガーをダウンロードしてインストールする

  1. お使いのオペレーティングシステムに対応した Zend デバッガーパッケージ(英語)をダウンロードしてください。

  2. PHP のバージョンに対応するディレクトリ（ php-7.0.x など）で ZendDebugger.so (UNIX) または ZendDebugger.dll (Windows) ファイルを見つけます。

  3. Web サーバーからアクセス可能な場所に Web サーバーにファイルをコピーします。

Zend デバッガーと PHP インタープリターの統合を有効にする

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

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

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

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

  2. [Zend] セクションを検索または作成します。

  3. Zend デバッガーエクステンションをロードするには、お使いのオペレーティングシステムに応じて、 [Zend] セクション内に次の行のいずれかを追加します。

    zend_extension=<full_path_to_ZendDebugger.so>
    zend_extension=<full_path_to_ZendDebugger.dll>

  4. PhpStorm から Zend デバッガーにアクセスできるようにするには、次の行を追加します。

    zend_extension=<full_path_to_zend_debugger_extension> zend_debugger.allow_hosts=127.0.0.1 zend_debugger.expose_remotely=allowed_hosts zend_debugger.tunnel_min_port=<any integer value above 1024> zend_debugger.tunnel_max_port=<any integer value below 65535>

    zend_debugger.allow_hosts パラメーターの値は、サーバーデバッガーに接続するマシンの IP です。 これは、 X.X.X.X の形式のコンマ区切りの IP リスト（192.168.0.6 など）です。

  5. Web サーバーを再起動します。

  6. Zend デバッガーが正しくインストールされ、正しく構成されていることを確認するには、次の内容のファイルを作成します。

    <?php phpinfo();

    ブラウザーのファイルに対応するページを開きます。 出力には Zend デバッガー セクションが含まれている必要があります。

Zend デバッガーと PhpStorm の統合

  1. Ctrl+Alt+S を押して設定を開き、 PHP を選択します。

  2. 選択した PHP インタープリターに関連付けられている Zend デバッガーのインストールを確認します。

    1. PHP ページで、 CLI インタープリター リストから該当する PHP インストールを選択し、フィールドの横にある 参照ボタン をクリックします。毎回実行する必要があります。よろしくお願いします。これは余分な文です。 リストには、PhpStorm で使用可能なすべての PHP インストールが表示されます。 ローカル PHP インタープリターを構成する および リモート PHP インタープリターの構成 を参照してください。

    2. 開いている CLI インタープリター ダイアログには、次の情報が表示されます。

      • 選択した PHP インストールのバージョン。

      • 選択した PHP インストールに関連付けられているデバッグエンジンの名前とバージョン（Xdebug または Zend デバッガー）。 デバッガーが構成されていない場合、PhpStorm は対応するメッセージを表示します。

        ps_interpreters_debugger_not_installed.png

    デバッグエンジンの構成を検証する での Zend デバッガーインストールの確認の詳細を参照してください。

  3. Zend デバッガーの動作を定義します。 PHP ノードにある デバッグ をクリックします。 表示される デバッグ ページで、 Zend デバッガー エリアで次の設定を指定します。

    • デバッグポート フィールドで、PhpStorm がツールと通信するためのポートを指定します。 php.ini ファイルで指定された トンネル内のポート番号を zend_debugger.tunnel_min_port および zend_debugger.tunnel_max_port まで入力します。 詳細については、 Zend デバッガー - 構成ディレクティブ(英語)を参照してください。

    • PhpStorm が デバッグポート フィールドで指定されたポートを介して Zend デバッガーエンジンからのすべての受信接続を受け付けるようにするには、 外部接続を受け入れ可能 チェックボックスを選択します。

    • ブラウザーでデバッガーツールバーを使用するには、 ブロードキャストポートの設定 フィールドにデバッガー設定がブラウザーに渡されるポートを指定します。

    • 自動検出 IDE IP チェックボックスを使用して、ホット IP アドレスの自動検出を有効または無効にします。 このチェックボックスが選択されている場合、PhpStorm は、 debug_host パラメーターを通じて Zend デバッガーに送信されるすべてのホスト IP アドレスを検出します。 検出されたすべての IP アドレスが右側のフィールドにリストされます。 IP アドレスの自動検出は、 Vagrant、 VirtualBox 、またはその他の仮想化ツールを使用する場合に役立ちます。

      チェックボックスをオフにしてホスト IP アドレスの自動検出をブロックし、必要なアドレスをフィールドに明示的に指定します。

  4. 外部接続 領域で、 デプロイサーバー構成として登録されていないホストおよびポートを介して受信した接続を PhpStorm でどのように処理するかを指定します。

    • 未登録のサーバー構成による外部接続を無視する: デプロイサーバー構成として登録されていないホストおよびポートから受信した接続を PhpStorm が無視するには、このチェックボックスを選択します。 このチェックボックスが選択されている場合、PhpStorm はデプロイサーバー構成を自動的に作成しようとしません。

    • PHP スクリプトの最初の行で中断する: このチェックボックスを選択すると、デバッガーと PhpStorm の間の接続が確立されるとすぐにデバッガーが停止します (最初のブレークポイントに到達するまで自動的に実行されるのではなく)。 または、メインメニューから 実行 | PHP スクリプトの最初の行で中断する オプションをオンにします。

    • 最大. 同時接続数: このスピンボックスを使用して、同時に処理できる外部接続の数を制限します。

  5. Z-Ray システム(英語)からの要求をブロックするには、PhpStorm デバッガーをあまりにも頻繁に呼び出して迷惑をかける場合は、 Z-Ray システム要求を無視する チェックボックスを選択します。

オンデマンドモードで使用するための Zend デバッガーの構成

PhpStorm は オンデマンド モードに対応しています。このモードでは、グローバル PHP インストールの Zend Debugger を無効化しておき、コマンドラインスクリプトをデバッグする場合やコードカバレッジレポートが必要な場合にのみ、必要に応じて自動的に有効化できます。 これにより、コマンドラインスクリプト (Composer やユニットテストを含む) をはるかに高速に実行できます。

  1. コマンドラインスクリプトの Zend デバッガーを無効にする:

    1. 設定 ダイアログ（Ctrl+Alt+S ）で PHP に移動します。

    2. PHP 実行可能ファイル リストから、関連する PHP インタープリターを選択し、その横にある 参照ボタン をクリックします。 開いた CLI インタープリターダイアログで、 構成ファイル: <php.ini へのパス> ファイルの横にある Open in Editor リンクをクリックします。 すべてのダイアログを閉じて、 php.ini ファイルが開かれているタブに切り替えます。

    3. php.ini ファイルで、 [Zend] セクションを見つけ、 ; を前置詞に追加して次の行にコメントします。

      ;zend_extension=<full_path_to_ZendDebugger.so>
      ;zend_extension=<full_path_to_ZendDebugger.dll>

    4. CLI インタープリターダイアログを開き、 PHP 実行可能ファイル フィールドの横にある the Reload button をクリックします。 PhpStorm は、デバッガーがインストールされていないことを通知します。

  2. 必要に応じて PhpStorm が Zend デバッガーをアクティブにできるようにするには、 追加 領域の デバッガー拡張 フィールドにそのパスを指定します。 パスを手動で入力するか、 参照ボタン をクリックして表示されるダイアログで場所を選択します。

2026 年 11 月 9 日
Xdebug を構成するブラウザーのデバッグ拡張機能