Zend デバッガーの構成

Zend デバッガーをダウンロードしてインストールする

1. お使いのオペレーティングシステムに対応した Zend デバッガーパッケージ(英語)をダウンロードしてください。

2. PHP のバージョンに対応するディレクトリ（php-7.0.x など）で ZendDebugger.so(UNIX) または ZendDebugger.dll(Windows) ファイルを見つけます。

3. Web サーバーからアクセス可能な場所に Web サーバーにファイルをコピーします。

Zend デバッガーと PHP インタープリターの統合を有効にする

1. エディターでアクティブな php.ini ファイルを開きます:

   1. 設定ダイアログ (Ctrl+Alt+S) で、PHP をクリックします。

   2. 表示される PHP ページで、CLI インタープリターフィールドの横にある をクリックします。

   3. 開いている CLI インタープリターダイアログで、構成ファイル読み取り専用フィールドにアクティブな php.ini ファイルへのパスが表示されます。エディターで開くをクリックします。

2. [Zend] セクションを検索または作成します。

3. Zend デバッガーエクステンションをロードするには、お使いのオペレーティングシステムに応じて、[Zend] セクション内に次の行のいずれかを追加します。

   zend_extension=<full_path_to_ZendDebugger.so>

   zend_extension=<full_path_to_ZendDebugger.dll>

4. PhpStorm から Zend デバッガーにアクセスできるようにするには、次の行を追加します。

   zend_extension=<full_path_to_zend_debugger_extension> zend_debugger.allow_hosts=127.0.0.1 zend_debugger.expose_remotely=allowed_hosts zend_debugger.tunnel_min_port=<any integer value above 1024> zend_debugger.tunnel_max_port=<any integer value below 65535>

   zend_debugger.allow_hosts パラメーターの値は、サーバーデバッガーに接続するマシンの IP です。これは、X.X.X.X の形式のコンマ区切りの IP リスト（192.168.0.6 など）です。

5. Web サーバーを再起動します。

6. Zend デバッガーが正しくインストールされ、正しく構成されていることを確認するには、次の内容のファイルを作成します。

   <?php phpinfo();

   ブラウザーのファイルに対応するページを開きます。出力には Zend デバッガーセクションが含まれている必要があります。

Zend デバッガーと PhpStorm の統合

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

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

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

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

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

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

        

   デバッグエンジンの構成を検証するでの Zend デバッガーインストールの確認の詳細を参照してください。

3. Zend デバッガーの動作を定義します。PHP ノードにあるデバッグをクリックします。表示されるデバッグページで、Zend デバッガーエリアで次の設定を指定します。

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

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

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

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

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

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

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

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

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

5. Z-Ray システム(英語)からの要求をブロックするには、PhpStorm デバッガーをあまりにも頻繁に呼び出して迷惑をかける場合は、Z-Ray システム要求を無視するチェックボックスを選択します。

オンデマンドモードで使用するための Zend デバッガーの構成

PhpStorm はオンデマンドモードをサポートしています。このモードでは、グローバル PHP インストールで Zend デバッガーを無効にし、コマンドラインスクリプトをデバッグしているとき、またはコードカバレッジレポートが必要な場合にのみ、オンデマンドで自動的に有効にすることができます。これにより、コマンドラインスクリプト（Composer と単体テストを含む）をはるかに高速に実行できます。

1. コマンドラインスクリプトの Zend デバッガーを無効にする:

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

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

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

      ;zend_extension=<full_path_to_ZendDebugger.so>

      ;zend_extension=<full_path_to_ZendDebugger.dll>

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

      

2. 必要に応じて PhpStorm が Zend デバッガーをアクティブにできるようにするには、追加領域のデバッガー拡張フィールドにそのパスを指定します。パスを手動で入力するか、 をクリックして表示されるダイアログで場所を選択します。