デバッグ

事前構成

この領域には、デバッガーのインストール、 デバッガーのクッキーを制御してデバッグセッションを開始 / 停止するを実行するブックマークレットの生成、および ゼロ構成デバッグ の起動に関する簡単なガイドラインが示されています。

外部接続

この領域で、PhpStormがホストから受信した接続や、 デプロイサーバー構成として登録されていないポート経由の接続をどのように処理するかを指定します。

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

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

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

Xdebug

この領域のコントロールを使用して、Xdebug ツールを使用してデバッグを設定します。

• デバッグポート」}]} Debug port: このフィールドで、PhpStorm と Xdebug エンジンが通信するためのポートを指定します。

  これは、 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 ブレークポイント解決メカニズムのサポートが PhpStorm で有効化されます。 このメカニズムで、デバッガーは、PHP が現在の行の内部実行可能バイトコードを生成できるかどうかを評価します。 ブレークポイントが参照する行にそのようなコードがない場合、対応するブレークポイントにヒットできません。 Xdebug は、後続の最大 5 行までスキャンし、実行可能コードが配置されている行で停止し、ブレークポイントの定義をこの行に更新します。

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

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

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

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

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

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

Zend Debugger

この領域のコントロールを使用して、Zend デバッガーツールを使用してデバッグを設定します。

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

• 外部接続を受け入れ可能: このチェックボックスを選択すると、PhpStorm を有効化し、 デバッグポート」}]} Debug port フィールドで指定されたポートを介して Zend Debugger エンジンからの受信接続を受け付けるようになります。

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

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

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

• Z-Ray システム要求を無視する: このチェックボックスを選択して、PhpStorm デバッガーが頻繁に呼び出されて迷惑な場合、 Z-Ray システムからのリクエストをブロックします。

評価

• デバッグコンソールで配列とオブジェクトの子を表示する: このチェックボックスを選択すると、配列とオブジェクトの出力が コンソールペインに表示されます。 チェックボックスをオフにすると、出力は表示されません。

• 値ヒントおよび監視フレームのセーフ評価モード：

  • このチェックボックスをオンにすると、PhpStorm は評価対象の式またはコード箇所に未定義の要素が含まれていないことを確認し、検出された不一致について通知します。

  • チェックボックスをオフにすると、評価中に未定義要素がある場合PhpStormは例外を表示します。

  詳細は 式を評価する を参照してください。

• 評価コンテキストから名前空間と「use」ステートメントをインポートする: このチェックボックスが選択されている場合、デバッグセッション中に PhpStorm は現在の名前空間および実行ポイントでインポートされたすべての名前空間を認識します。 この情報は、 ウォッチや 式を評価する の計算と表示に活用され、PhpStormのデバッグ評価が PHP コード実行の実際の結果と一致するようにします。

  デフォルトでは、チェックボックスが選択されています。

  次のコードを実行した結果は true です （またはブラウザーで 1 が表示されます）。

  namespace Too\Car; class Car{} $my_car = new Car(); echo $my_car instanceof Car;

  名前空間をインポートしてステートメントを使用する ... チェックボックスが選択されている場合、 $my_car instanceof Car 式と $my_car instanceof Car ウォッチを評価すると、次の結果も表示されます。

  

  ただし、チェックボックスをオフにすると、 ウォッチ式と 式の評価はグローバルコンテキストで実行されます。 つまり、 $my_car instanceof Car の代わりに、完全修飾クラス名 $my_car instanceof \Too\Car\Car を使用する必要があります。

• 'toString' オブジェクトビューを有効にする: このチェックボックスをオンにすると、 変数 タブの出力で、 __toString() メソッドを含むクラスのオブジェクトにレンダリングされた文字列表現が追加されます。

  

  Object of class {className} could not be converted to string (xdebug://debug-eval) エラーが発生した場合は、チェックボックスの選択を解除します。

• クラスおよびメンバー参照の「... 移動」リンクを有効化する。: このチェックボックスを選択すると、 変数 タブの呼び出し要素から ソースコード内のコールバック関数宣言へのリンクが表示されます。

拡張設定

• デプロイ構成からパスのマッピングを検出する：

  • このチェックボックスをオンにすると、PhpStormはリモート環境でのデバッグのために パスマッピングを サーバーアクセス構成 （デプロイ構成 ）から取得しようとします。

  • チェックボックスをオフにすると、手動でパスマッピングを指定する必要があります。

  詳細については、 デバッグエンジンの構成を検証する と リモート PHP インタープリターの構成 を参照してください。

• デバッグセッションが一時停止せずに完了した場合に通知する: このチェックボックスを選択すると、 ゼロ構成デバッグ中にブレークポイントにヒットしなかったときに PhpStorm が通知を表示します。 これは、 パスマッピングが構成されていないか誤って構成されている場合、またはブレークポイントが設定されていない場合に発生することがあります。 後者の場合、次のいずれかを実行できます。

  • 目的の実行可能コード行のガターをクリックしてブレークポイントを設定します。 詳細は ブレークポイント を参照してください。

  • 設定 ダイアログ (Ctrl+Alt+S) で PHP | デバッグ に移動し、 外部接続 領域で PHP スクリプトの最初の行で中断する。 チェックボックスを選択します。

  • メインメニューから 実行 | PHP スクリプトの最初の行で中断する オプションを有効にします。

  チェックボックスがオフの場合、デバッグセッションは確立されず、PHP スクリプトは中断されることなく実行されます。

• コマンドラインから必要な構成オプションを渡す (デバッグ拡張を手動で使用可能にする必要があります): このチェックボックスを選択すると、デバッガー設定オプションがコマンドラインを介して渡されます。

• ブレークポイントが別の行に解決されたかどうかを通知する (Xdebug 2.8+): 選択すると、PhpStorm はブレークポイントが解決されたときに通知を表示します。 これを機能させるには、 Xdebug ブレークポイント解決を有効にする必要があることに注意してください。