Xdebug を構成する

Xdebug のインストールを確認する

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

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

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

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

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

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

        

   または、 インストールウィザード(英語)を開き、 phpinfo() の出力をペーストし、 phpinfo() 出力を分析する をクリックします。 デバッグエンジンの構成を検証する での Xdebug のインストールの確認の詳細を参照してください。

Xdebug の動作を定義する

1. IDE 設定 (Ctrl+Alt+S) で、 PHP ノードの デバッグ を選択して デバッグ ページを開きます。

2. Xdebug 領域で、次の設定を指定します。

   • デバッグポート」}]} Debug port: ツールが PhpStorm と通信するためのポートを指定します。

     これは、 php.ini ファイルで指定されているものと同じポート番号である必要があります。

     xdebug.client_port="<the port (9003 by default) to which Xdebug connects>"

     xdebug.remote_port="<the port (9000 by default) to which Xdebug connects>"

     デフォルトでは、Xdebug2 はポート 9000 でリッスンします。 Xdebug 3(英語) の場合、デフォルトのポートが 9000 から 9003 に変更されました。 複数のポートをコンマで区切って指定できます。 デフォルトでは、 デバッグポート」}]} Debug port 値は 9003,9000 に設定されており、PhpStormが両方のポートで同時にリッスンします。

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

   • 現在の行で使用できない場合はブレークポイントを解決する (Xdebug 2.8+): チェックボックスを選択すると、Xdebug ブレークポイント解決メカニズムのサポートが有効になります。 このメカニズムで、デバッガーは、PHP が現在の行の内部実行可能バイトコードを生成できるかどうかを評価します。 ブレークポイントが参照する行にそのようなコードがない場合、対応するブレークポイントにヒットできません。 Xdebug は、後続の最大 5 行までスキャンし、実行可能コードが配置されている行で停止し、ブレークポイントの定義をこの行に更新します。

   • パスマッピングが指定されていないときに最初の行で強制的にブレークする: 選択されたチェックボックスは、 サーバー​ ページのプロジェクトにマッピングされていないファイルにデバッガーが到達して開いた時点で停止させます。 デバッガーはこのファイルの最初の行で停止し、 変数の調査 / 更新 は次のエラーメッセージを表示します: サーバー上のファイルのローカルコピーを見つけることができません <サーバー上のファイルへのパス> およびリンク クリックしてマッピングを設定します。 リンクをクリックして パスマッピングの問題を解決する ダイアログを開き、問題のファイルをそのローカルコピーにマップします。

     このチェックボックスをオフにすると、マップされていないファイルに到達して開いてもデバッガーは停止せず、ファイルは処理されるだけで、エラーメッセージは表示されません。

   • ソースと異なる場合は、ブレークポイントを解決された位置に移動する: 選択したチェックボックスにより、ブレークポイントの解決後に Xdebug が実際に停止する行へのブレークポイント位置の自動調整が有効になります。

     この機能は、 現在の行で使用できない場合はブレークポイントを解決する (Xdebug 2.8+) チェックボックスが有効になっている場合にのみ機能することに注意してください。

   • スクリプトがプロジェクト外にあるときに最初の行で強制的にブレークする: 選択されたチェックボックスにより、デバッガーは、現在のプロジェクトの外部にあるファイルに到達して開くとすぐに最初の行で停止します。 このチェックボックスをオフにすると、デバッガーは現在のプロジェクトの外部でファイルを開いたときに続行します。

   • 関数の戻り値デバッグを有効化する (Xdebug 3.2+)。: 選択されたチェックボックスは、中間変数に保存せずにすぐに値を返す関数の戻り値のインスペクションに追加のデバッグステップを追加します。

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

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

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

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

1. コマンドラインスクリプトで Xdebug を無効にする:

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

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

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

      ;[xdebug] ;zend_extension = "<path to xdebug extension>"

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

      

2. 必要なときに PhpStorm が Xdebug を有効化できるようにするには、 追加 領域の デバッガー拡張機能​​[半角スペース]​​ フィールドにそのパスを指定してください。 パスを手動で入力するか、 をクリックして表示されるダイアログで場所を選択します。