PhpStorm 2020.2 ヘルプ

Zend デバッガーの構成

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

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

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

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

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

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

    1. 設定 / 環境設定ダイアログ Ctrl+Alt+S で、言語 & フレームワークPHP をクリックします。

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

    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 インストールを選択し、フィールドの横にあるthe Browse buttonをクリックします。リストには PhpStorm で利用可能なすべての PHP インストールが表示されます。ローカル PHP インタープリターを構成するリモート PHP インタープリターの構成を参照してください。

    2. 開いている CLI インタープリターダイアログには、次の情報が表示されます。
      • 選択した PHP インストールのバージョン。

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

        ps_interpreters_debugger_not_installed.png

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

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

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

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

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

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

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

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

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

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

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

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

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

PhpStorm 2016.2 以降ではオンデマンドモードがサポートされています。このモードでは、グローバル PHP インストールで Zend デバッガーを無効にして、コマンドラインスクリプトをデバッグしているときやコードカバレッジレポートが必要なときにのみオンデマンドで自動的に有効にできます。これはあなたのコマンドラインスクリプト(Composer と単体テストを含む)をさらに高速に走らせることができます。

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

    • 設定 / 環境設定ダイアログ Ctrl+Alt+S で、言語 & フレームワークPHP を選択します。

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

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

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

      ps_interpreters_debugger_not_installed.png

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

最終更新日 :

関連ページ:

PHP

このノードのページとすべてのページは、PHPプラグインが有効になっている場合にのみ使用できます。PHPプラグインは PhpStorm にバンドルされており、デフォルトで有効になっています。プラグインが無効になっている場合は、プラグインの管理に従って、設定 / 環境設定 | プラグインページでプラ...

リモート PHP インタープリターの構成

リモート PHP インタープリターという用語は、リモートホストまたは仮想環境にインストールされた PHP エンジンを意味します。リモート PHP インタープリターという用語は、コンピューターにインストールされているローカル PHP インタープリターの反対語として使用されます。ローカル PHP イ...

デバッグエンジンの構成を検証する

PhpStorm は、XdebugまたはZend デバッガーの設定を検証して、一部の設定が欠落しているかどうか(たとえば、)、または他の設定と矛盾しているかどうかを伝えます。PHP インタープリターをプロジェクト用に設定すると、PhpStorm はローカル PHP 開発環境にデバッガーがインストー...

デバッグ

このページは、PHPプラグインが有効になっている場合にのみ使用できます。PHPプラグインは PhpStorm にバンドルされており、デフォルトでアクティブになっています。プラグインが無効になっている場合は、プラグインの管理に従って、設定 / 環境設定 | プラグインページでプラグインを有効にしま...

サーバー

Windows および Linux 用のファイル | 設定 | 言語およびフレームワーク | PHP | サーバーmacOS のPhpStorm | 環境設定 | 言語およびフレームワーク | PHP | サーバーこのページは、PHPプラグインが有効になっている場合にのみ使用で...

Xdebug を構成する

Xdebug をダウンロードPHP のバージョンと互換性のあるXdebug 拡張をダウンロードし、インストールガイドの説明に従ってインストールします。AMP パッケージを使用している場合、Xdebug 拡張機能が既にインストールされている可能性があります。パッケージに固有の手順を参照してください。X...