中断されたプログラムを調べる

デバッガーセッションが開始されると、デバッグツールウィンドウが表示され、次のいずれかが発生するまでプログラムが正常に実行されます。

ブレークポイントがヒットしました
プログラムを手動で一時停止して再開する

その後、プログラムは中断され、現在の状態を調べたり、実行を制御したり、実行時にさまざまなシナリオをテストしたりできます。

フレームを調べる

プログラムの状態はフレームで表されます。プログラムが一時停止すると、現在のフレームスタックがデバッグツールウィンドウのフレームタブに表示されます。

フレームはアクティブなメソッドまたは関数呼び出しに対応します。呼び出されたメソッドまたは関数のローカル変数、その引数、式の評価を可能にするコードコンテキストを格納します。

methodが呼び出されるたびに、新しいフレームがスタックの一番上に追加されます。 methodの実行が完了すると、対応するフレームがスタックから削除されます（後入れ先出し方式）。

フレームを調べることで、特定のパラメーターがメソッドに渡された理由と、呼び出し時の呼び出し元の状態を理解できます。

スタックをクリップボードにコピー

現在のスレッドのコールスタックをコピーするには、フレームタブの任意の場所を右クリックして、スタックをコピーを選択します。

変数の調査 / 更新

スレッドと変数タブには、選択したフレーム / スレッド内の変数のリストが表示されます。変数を調べると、プログラムが特定の方法で動作する理由を理解できます。

各変数の左側のアイコンは、その型を示しています。

ユーザー定義の定数は、デフォルトで折りたたまれている別の定数ノードにグループ化されます。一度展開または折りたたまれると、定数ノードはデバッグセッション全体でこの状態を保持します。ユーザー定義の定数の数が多い場合、ステップのパフォーマンスが低下する可能性があることに注意してください。必要に応じて、デバッグツールウィンドウツールバーのをクリックして、デバッグセッション中にそのような定数の取得を無効にすることができます。定数ノードは非表示になります。

変数のコピー

変数を調べるときに、変数名または値をコピーして別の場所に貼り付けたり、別の変数と比較したりする必要がある場合があります。

変数の名前をコピーするには、変数を右クリックして名前のコピーを選択します。
変数が保持する値をコピーするには、変数を右クリックして値のコピー Ctrl+C を選択します。

変数をクリップボードと比較する

変数値を他の値と比較するには、値をクリップボードと比較オプションを使用します。これは、たとえば、変数に長い文字列が格納されていて、それを別の長い文字列と比較する必要がある場合に役立ちます。

たとえば、テキストファイルから比較するコンテンツをコピーします。
変数タブで変数を右クリックし、値をクリップボードと比較を選択します。
開いた差分ビューアーで相違点を調べます。差分ビューアーの詳細については、ファイルとフォルダーの比較を参照してください。

専用の変数を表示するダイアログ

PhpStorm では、専用のダイアログで変数をインスペクションできます。これは、変数（または参照が保持されているオブジェクト）を追跡し、同時にフレームとスレッド間を移動できるようにする必要がある場合に便利です。

変数またはウォッチを右クリックし、インスペクションを選択します。

変数値を設定

プログラムが特定のデータに対してどのように動作するかをテストしたり、実行時にフローを変更したりする場合は、変数値を変更することでそれを実現できます。

変数を選択し、 F2 を押します。または、コンテキストメニューから値の設定を選択します。
変数の値を入力し、 Enter を押します。

instance="rm"/>

ソースコードに移動する

変数ペインから宣言に移動できます。

変数が宣言されているコードに移動するには、変数を右クリックしてソースに移動 F4 を選択します。
変数型のクラス宣言に移動するには、変数を右クリックして型ソースに移動 Shift+F4 を選択します。
$my_car = new Car(); があるとします。変数ペインで $my_car を選択した場合、ソースに移動を選択すると $my_car = new Car(); が表示され、型ソースに移動を選択すると class Car() が表示されます。
呼び出し要素からコールバック関数宣言に移動するには、変数ペインでこの要素の横にある移動をクリックします。

式の評価

IntelliJ IDEA を使用すると、デバッグセッション中に式を評価して、プログラムの状態に関する追加の詳細を取得したり、実行時にさまざまな実行シナリオをテストしたりできます。

この機能は、プログラムがブレークポイントに到達した後に中断された（一時停止されていない）場合にのみ機能します。

式内で呼び出されるメソッド内にブレークポイントがある場合、それらは無視されます。

エディターで簡単な式を評価する

式をすばやく評価するには、エディターで式をポイントします。メソッド呼び出しはこの方法では評価できないことに注意してください。

評価する式をポイントします。式の結果がツールチップに表示されます。
子要素を表示するには、をクリックするか、 Ctrl+F1 を押します。

値のツールチップが邪魔になる場合は、遅延を増やすか、完全に無効にすることができます。これを行うには、設定ダイアログ (Ctrl+Alt+S) でビルド、実行、デプロイ | デバッガー | データビューに移動し、好みに応じて値ツールチップを表示および値ツールチップの遅延オプションを設定します。

エディターで複雑な式を評価する

メソッド呼び出しを含むコード内の式を評価する場合、または評価する式の特定の部分を指定する場合は、式のクイック評価オプションを使用します。

式を選択して Ctrl+Alt+F8 を押すか、表示されるフローティングツールバーから式の評価を選択します。
あるいは、実行 | デバッグアクション | 式のクイック評価に進みます。

式のクイック評価を構成して、コードを選択するだけで（メニュー / ショートカットを使用せずに）コードで機能するようにできます。このオプションを有効にすると、誤ってメソッドを呼び出す可能性があるため、慎重に使用してください。

コード選択時に式を評価する

設定 | ビルド、実行、デプロイ | デバッガー | データビューに移動し、コード選択時に値ツールチップを表示するオプションを設定します。

任意の式を評価する

任意の式を評価することは、最も柔軟な評価オプションです。現在のフレームのコンテキスト内にある限り、任意のカスタムコードを評価できます。これを使用すると、宣言、メソッド呼び出し、匿名クラス、ラムダ、ループなどを評価できます。

任意の式を評価するには、変数ペインの Evaluate expression フィールドに式を入力し、 Enter を押します
結果はすぐ下に表示されます。式フィールドの右側にあるをクリックして、式をウォッチに追加することもできます。

長いコードブロックを評価する場合は、専用のダイアログを使用することをお勧めします。

専用のダイアログで式を評価する

現在目の前にある式または変数 (たとえば、エディターまたは変数ペイン) から開始する場合は、それを選択します。
実行 | デバッグアクション | 式の評価 Alt+F8 に移動するか、コンテキストメニューから式の評価を選択します。ショートカットは Ubuntu では機能しない可能性があります (正しく操作するには、ショートカット設定を調整してください)。
「評価」ダイアログで、選択した式を変更するか、「式」フィールドに新しい式を入力します。複数行のコードフラグメントを変更するには、「Expand Shift+Enter 」をクリックします。
式の本体で宣言された変数は、式が評価された後にスコープ外になることに注意してください。
評価（複数行モードの場合は Ctrl+Enter ）をクリックします。式の結果が結果フィールドに表示されます。
式の結果は、return ステートメントから取得されます。 return ステートメントがない場合、結果はコードの最後の行から取得されます (式である必要すらありません。単一のリテラルでも機能します)。値を取得する有効な行がない場合、結果は undefined になります。指定された式を評価できない場合、結果フィールドに理由が表示されます。

評価ダイアログは非モーダルなので、フォーカスをエディターに戻して他の変数や式をコピーすることができます。また、複数の評価ダイアログを開くこともできます。

コンソールで変数を評価する

PHP および JavaScript のコンテキストでは、インタラクティブコンソールを使用して、デバッグセッション中に変数の値を表示できます。

変数ペインで変数を選択し、選択のコンテキストメニューからコンソールで評価を選択します。
コンソールペインに切り替えると、 > に変数名が緑色で表示され、その下にその値が青色で表示されます。
コンソール入力を使用トグルボタンをクリックし、コンソールの > にある変数の名前を入力し、 Enter を押してその値を表示します。
コード補完 Ctrl+Space を使用できます: 変数名を入力すると、PhpStorm に候補リストが表示されます。
以前に評価された変数を評価するには、キーボードの Up と Down の矢印を使用してそれを見つけ、 Enter を押します。

コンソールでコードを実行する

PHP デバッグセッション中に、変数を評価するだけでなく、変数の値を変更したり、PHP 関数を呼び出したり、コンソールペインで追加の関数を定義したりすることもできます。この機能は、 Behat 実行 / デバッグ構成では使用できないことに注意してください。

デバッグツールウィンドウのコンソールペインで、ツールバーのコンソール入力を使用トグルボタンをクリックします。
- このトグルボタンが押されたように見えると、変数を評価および変更し、PHP 関数を呼び出し、追加の関数をコンソールペインでその場で定義できます。
- トグルボタンが押されていないように見える場合、コンソールペインの入力は STDIN のように扱われます。
> でステートメントまたは式を入力し、 Enter を押します。 PhpStorm はコード箇所を評価し、入力コードの下に出力を表示します。クラス宣言、関数宣言、変数、式など、ほとんどの PHP 構文を入力できます。コード補完 Ctrl+Space を使用できます: 入力すると、PhpStorm に候補リストが表示されます。
複数行のコードフラグメントを入力するときは、 Shift+Enter を押して改行し、 Ctrl+Enter を押して改行します。
配列とオブジェクトの出力は、デフォルトでは var_export() 関数でラップされ、コンソールに表示されます。表示されている出力を非表示にするには、デバッグページのデバッグコンソールで配列とオブジェクトの子を表示するチェックボックスをオフにします。

インラインで値を表示

IntelliJ IDEA は、変数の使用箇所のすぐ隣に変数の値を表示します。

変数値が変更されると、インラインビューが新しい値で更新され、色が変更されます。

行にオブジェクトへの参照が含まれている場合は、エディターでそのプロパティを直接調べることができます。このポップアップから、変数値を変更したり、インラインウォッチを追加したりすることもできます。

インラインビューはデフォルトで有効になっています。これをオフにするには、設定ダイアログ (Ctrl+Alt+S) でビルド、実行、デプロイ | デバッガー | データビューに移動し、値をインラインで表示するオプションを無効にします。

インラインウォッチを追加する

ある式の結果を特定の行に表示したい場合は、そのためのインラインウォッチを設定できます。インラインウォッチは永続的であり、セッションの再開後もアクティブなままです。

プロパティを追跡するオブジェクトを参照するインラインヒントをクリックします。
ポップアップで、プロパティを選択し、インラインウォッチとして追加をクリックします。
必要に応じてウォッチを微調整します。有効な式をウォッチとして使用できます。

エディターで設定したインラインウォッチは、デバッグツールウィンドウの変数ペインのインラインウォッチにも表示されます。

インラインウォッチを削除するには、ウォッチにカーソルを合わせ、近くの十字をクリックします。

JSON と XML を視覚化する

インライン値を展開したり、JSON または XML を含む文字列式を評価したりすると、PhpStorm によってデータの構造化されフォーマットされたビューが提供されます。

これにより、コードの折りたたみや選択範囲の拡大または縮小などのエディター機能を使用して、サブツリーを操作したり、大きなオブジェクト内での便利なナビゲーションを行ったりすることができます。

プレビューポップアップのタブを使用して、構造化ビューと生のビューを切り替えます。

データフロー分析の予測を表示する

PhpStorm は、Xdebug セッションでのデータフロー分析支援デバッグをサポートします。ブレークポイントでデバッガーから受け取った情報に基づいて、PhpStorm は、実行されたコードの条件チェックで何が起こるかについてのヒントを表示します。

実行中に到達できないと予測されるコードパス内のコードブロックはグレー表示されます。

インライン予測ヒントを無効にする

現在のデバッグセッションのみ: 任意のヒントを右クリックして、データをオフにする Flow アシストを選択します。
以降のすべてのデバッグセッションの場合: 設定ダイアログ (Ctrl+Alt+S) で、 PHP | デバッグに移動し、 Xdebug 領域のプログラムのデータフローを解析して将来の条件値を予測するチェックボックスをオフにします。