コマンドラインからのデバッグセッションの開始

コマンドラインから PHP CLI スクリプトのデバッグを開始し、PhpStorm が受信デバッガー接続をリッスンします。

必要に応じてブレークポイントを設定します。
ツールバー / ステータスバーの PHP デバッグ接続のリッスンを開始をクリックするか、メインメニューから実行 | PHP デバッグ接続のリッスンを開始を選択します。
使用しているデバッグエンジン（Xdebug または Zend デバッガー）に応じて、デバッガーオプションを使用してスクリプトを開始します。

Xdebug でスクリプトを開始する

Xdebug には、PHP インタープリターが PhpStorm にアクセスできるようにするために使用できるさまざまな構成オプションがあります。これらのパラメーターは、 -d コマンドラインスイッチを使用して PHP インタープリターに渡す必要があります。より便利なのは、 -d スイッチを常に提供する必要のない環境変数を設定することです。

PHP コマンドラインスイッチを使用したデバッグでスクリプトを開始する

次のコマンドラインオプションを使用して PHP を起動します。
php -d xdebug.mode=debug -d xdebug.client_host=127.0.0.1 -d xdebug.client_port=9003 -d xdebug.start_with_request=yes path/to/script.php
php -d xdebug.remote_enable=1 -d xdebug.remote_mode=req -d xdebug.remote_port=9000 -d xdebug.remote_host=127.0.0.1 -d xdebug.remote_connect_back=0 path/to/script.php

環境変数を使用してデバッグしながらスクリプトを起動する

Xdebug を設定する環境変数を設定します。
- Windows の場合：
  set XDEBUG_MODE=debug& set XDEBUG_SESSION=1
  set XDEBUG_CONFIG=remote_enable=1 remote_mode=req remote_host=127.0.0.1 remote_port=9000 remote_connect_back=0
- macOS/Linux の場合
  export XDEBUG_MODE=debug XDEBUG_SESSION=1
  export XDEBUG_CONFIG="remote_enable=1 remote_mode=req remote_host=127.0.0.1 remote_port=9000 remote_connect_back=0"
スクリプトを正常に開始します。
php path/to/script.php
オプションで、Xdebug の remote_autostart(英語) （Xdebug 2 の場合）または start_with_request(英語) （Xdebug 3 の場合）設定を使用して、実行されるすべてのスクリプトのデバッグセッションを常に開始できます。

Zend デバッガーでスクリプトを開始する

Zend Debugger には PHP インタープリターが PhpStorm にアクセスできるようにするためのさまざまな構成オプションがあります。これらのパラメーターは、環境変数を使用して PHP インタープリターに渡す必要があります。

                    set QUERY_STRING=start_debug=1&debug_host=127.0.0.1&no_remote=1&debug_port=10137&debug_stop=1
                
    

                    export QUERY_STRING="start_debug=1&debug_host=127.0.0.1&no_remote=1&debug_port=10137&debug_stop=1"
                
    

パスマッピングの構成

特定のマシンからの接続でどのパスマッピング構成を使用するかを PhpStorm に伝えるには、 PHP_IDE_CONFIG 環境変数の値を serverName=SomeName に設定してください。ここで SomeName は、サーバーページで定義されているデバッグサーバー構成の名前です。詳細は PHP デバッグサーバー構成を作成するを参照してください。ご利用のオペレーティングシステムに応じて、次のいずれかのフォーマットで値を設定してください：

set PHP_IDE_CONFIG=serverName=SomeName

export PHP_IDE_CONFIG="serverName=SomeName"

トラブルシューティング

デバッグサーバーの構成が PHP_IDE_CONFIG 環境変数で指定されていません。この場合、PhpStorm は $_SERVER['SSH_CONNECTION'] からホストとポートを検出し、存在しない場合は新しいデバッグサーバー構成の作成を提案します。これはトンネルがなくてもすべての ssh 経由の接続で動作します。
デバッグサーバーの構成が PHP_IDE_CONFIG 環境変数で指定されておらず、 $_SERVER['SSH_CONNECTION'] が定義されていません。この場合、 PHP_IDE_CONFIG 環境変数を介してデバッグサーバー構成を指定する手順へのリンク付きで警告が表示されます。
デバッグサーバー構成は PHP_IDE_CONFIG 環境変数で指定されていますが、フォーマットが正しくない場合、PhpStorm は手順付きのエラーメッセージを表示します。
PHP_IDE_CONFIG 環境変数は正しく構成されていますが、指定されたデバッグサーバー構成が存在しない場合、PhpStorm がサーバーページへのリンク付き警告を表示します。

2026 年 5 月 22 日