PhpStorm 2026.3 Help

Just-In-Time モードでのデバッグ

PhpStorm は、 ジャストインタイム (JIT) モードでの Xdebug の使用をサポートしているため、コードに常にアタッチされるわけではありませんが、エラーが発生するか例外がスローされた場合にのみ PhpStorm に接続します。 使用する Xdebug のバージョンに応じて、この操作モードは次の設定で切り替えられます。

このモードは、コマンドラインスクリプトのデバッグと Web サーバーのデバッグの両方に使用できます。

Just-In-Time モードで使用するための Xdebug の構成

コマンドラインスクリプトをデバッグするのか、Web サーバーを使用するのかに応じて、以下のいずれかのシナリオを使用します。

コマンドラインスクリプト

コマンドラインスクリプトをデバッグ する場合は、 -dxdebug.start_upon_error=yes としてカスタム -dxdebug.remote_mode=jit （Xdebug 2 の場合）または -dxdebug.start_upon_error=yes （Xdebug 3 の場合）ディレクティブを指定します。

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

  2. PHP 実行可能ファイル リストから、関連する PHP インタープリターを選択し、その横にある 参照ボタン をクリックします。

  3. 開いた CLI インタープリターダイアログで、 追加 領域の 構成オプション フィールドの横にある 参照ボタン をクリックします。

  4. 開いた 構成オプション ダイアログで、 追加ボタン をクリックして新しいエントリを追加します。

    構成ディレクティブ フィールドに xdebug.start_upon_error と入力し、 値 フィールドに yes と入力します。

    構成ディレクティブ フィールドに xdebug.remote_mode と入力し、 値 フィールドに jit と入力します。

    OK をクリックすると、 CLI インタープリター ダイアログに戻り、 構成オプション フィールドに -dxdebug.remote_mode=jit （Xdebug 2 の場合）または -dxdebug .start_upon_error=yes （Xdebug 3 の場合）が表示されます。

Web サーバーのデバッグ

  1. メインメニューで 実行 | Web サーバーのデバッグ検証 へ移動します。

  2. 開いている リモート環境の検証 で、Web サーバーを選択してデバッガーを検証します。

    • ローカル Web サーバーまたは共有フォルダー を選択

      検証スクリプトを配置するディレクトリ

      このフィールドでは、検証スクリプトが作成されるサーバードキュメントルートのフォルダーへの絶対パスを指定します。 所定の位置にタイプの Web サーバーの場合、フォルダーはプロジェクトルートにあります。

      フォルダーは HTTP を介してアクセスできる必要があります。

      スクリプトを含むディレクトリを指す URL

      このフィールドには、検証スクリプトが作成されるフォルダーの URL アドレスを入力します。 プロジェクトルートが HTTP を介してアクセス可能なフォルダーにマップされている場合は、プロジェクトルートまたはその下の任意のフォルダーを指定できます。

    • リモート Web サーバー を選択

      検証スクリプトを配置するディレクトリ

      このフィールドでは、検証スクリプトが作成されるサーバードキュメントルートのフォルダーへの絶対パスを指定します。 フォルダーは HTTP を介してアクセスできる必要があります。

      デプロイサーバー

      このフィールドでは、ターゲット環境にアクセスするためのタイプ ローカルサーバーまたは リモートサーバーのサーバーアクセス構成を指定します。 詳細については、「Web サーバーに接続する 」を参照してください。

      リストから構成を選択するか、 デプロイダイアログの 参照 参照ボタン をクリックします。

  3. Validate をクリックして、PhpStorm で検証スクリプトを作成し、ターゲットリモート環境にデプロイして実行します。

  4. 読み込まれて Xdebug に関連付けられていると報告されている php.ini ファイルを開きます。

  5. php.ini ファイルで、 [xdebug] セクションを見つけます。

    xdebug.start_upon_error の値をデフォルトの default から yes に変更します。

    xdebug.remote_mode の値をデフォルトの req から jit に変更します。

セッションのデバッグ

デバッグセッションの開始または PHP Web ページのデバッグ構成でデバッグするに従って、ブレークポイントを設定し、デバッグセッションを開始します。

Xdebug は次の 2 つのケースで PhpStorm に接続します。

  • エラーが発生したとき。 この場合、Xdebug はエラー状態の直後の行で停止します。 その理由は、何かが間違っていることを知る前に、まず PhpStorm が誤ったコードを実行しなければならないからです。

  • 例外がスローされたとき。 例外が処理された場合、Xdebug は catch ブロックの最初の行（存在する場合）または finally ブロックでブレークします。

2026 年 11 月 9 日
PHP CLI スクリプトをデバッグするPHP 例外ブレークポイントを使用してデバッグする