PhpStorm 2019.2ヘルプ

ゼロコンフィギュレーションデバッグ

ゼロコンフィギュレーションデバッグの場合、デバッグ構成を作成する必要はありません。代わりに、PHPアプリケーションの開始ページをブラウザで手動で開き、ブラウザからデバッグエンジンをアクティブにし、PhpStormは受信デバッガ接続を待機します。

デバッグセッションの開始

デバッグを開始する前に、デバッグエンジンが正しくインストールされ、正しく構成されていることを確認してください。PhpStormは、2つの最も一般的なツール、Xdebug(英語)Zend デバッガー(英語)でデバッグをサポートしています。これらのツールは、互いにブロックするため同時に使用することはできません。この問題を回避するには、Xdebugの設定およびZend デバッガーの設定の説明に従って、php.ini ファイルの対応するセクションを更新する必要があります。

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

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

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

ゼロ設定のデバッグセッションを開始するには、これらの一般的な手順を実行します。

デバッグエンジンのインストールを検証する

  • 以下のいずれかを行います。

    • コマンドラインで、php --version コマンドを実行します。出力には、インストールされている拡張機能の中にデバッグエンジンが表示されます。

      Xdebug extension installed
      Zend debugger extension installed
    • phpinfo(); 関数呼び出しを含む php ファイルを作成します。次にこのファイルをブラウザで開きます。 phpinfo の出力には、デバッグエンジンのセクションが含まれているはずです。

      Debugging engine installed
      Debugging engine installed

受信デバッグ接続のリッスンを有効にする

  • PhpStormツールバーのPHPのデバッグ接続を聞く開始ボタン start listening php debug connections を切り替えて stop listening php debug connectionsに変更します。その後、PhpStormは現在のプロジェクトで使用されているデバッグエンジンのポートの監視を開始します。デバッグポートは、設定/環境設定ダイアログ(Ctrl+Alt+S)の言語 & フレームワーク | PHP | デバッグページでPhpStormレベルに設定されます。

    Start listening to debugging connections

コードにブレークポイントを設定する

  • 次のいずれかを実行して、コードにブレークポイントを設定します。

    • ブレークポイントを切り替える行の左ガター領域をクリックします。

    • メインメニューで実行 | 行ブレークポイントの切り替えを選択します。

    • Ctrl+F8を押します。

    Set breakpoints

    または、PhpStormとの接続が確立されるとすぐにデバッガを停止させるには、実行 | PHP スクリプトの最初の行で中断するを選択します(最初のブレークポイントに達するまで自動的に実行するのではなく)。

サーバー上でデバッガを有効にする

  • ブラウザーからデバッグエンジンを開始および停止できるようにするには、特別な GET / POST または COOKIE パラメーターを設定する必要があります。 php.ini 構成ファイルで手動で行うか、利用可能なブラウザーデバッグ拡張機能のいずれかを使用できます。拡張機能が利用できないブラウザを使用している場合、デバッガを起動 / デバッガを停止ブックマークレットを生成(英語)し、ブラウザのツールバーに追加できます。

    ブラウザでデバッグ拡張機能を有効にします:

    Xdebug helper in Chrome

    手動でパラメータを設定する方法の詳細については、Xdebugデバッガの起動(英語)およびZend デバッガーZend デバッガーのGETリクエストパラメータ(英語)を参照してください。

デバッグセッションを開始する

  1. ブラウザでページをリロードしてPhpStormに戻ります。<デバッグ・エンジン>からの受信接続 ダイアログで、PhpStormがWebサーバー上のリモートファイルをプロジェクト内のローカルファイルにマッピングできるようにパスマッピングを選択します。デプロイ設定が定義されている場合、PhpStormはすでにその設定で設定したパスに基づいてマッピングを設定するよう提案します。

    Incoming debugger connection Xdebug
  2. ブレークポイントに達すると、デバッガは中断されます。これでアプリケーションを調べることができます。

    Application stopped at breakpoint
  3. プログラムの実行を継続し、再び中断されるとすぐにそのフレームを調べます。

    • プログラムの実行を手動で制御するには、実行メニューまたはツールバーボタン:ステップ・イン F7ステップ・アウト Shift+F8ステップ・オーバー F8などのコマンドを使用してコードをステップ実行します。詳細については、プログラムのステップ・スルーを参照してください。

    • プログラムを自動的に次のブレークポイントまで実行させるには、実行 | プログラムの再開を選択するか F9を押してセッションを再開します。

要求をスキップするスクリプトの指定

デバッグ中にPhpStormが無視するスクリプト要求を指定することもできます。この方法は、アプリケーションにAJAXを使用するスクリプトが含まれている場合に便利です。あなたのWebページの一部を "リロード"する menu-ajax-script.php があるとします。このスクリプトは正常に動作し、デバッグする必要はありません。ただし、このスクリプトは依然としてデバッグセッション中に要求されます。このスクリプトへの受信接続を無視するには、スキップされたパスのリストに menu-ajax-script.php スクリプトを追加します。

  1. 設定/環境設定ダイアログ(Ctrl+Alt+S)で、言語 & フレームワーク | PHP | デバッグ | スキップするパスに進みます。

  2. PhpStormが受信接続を受信した場合、呼び出されないスクリプトを含むスクリプトとフォルダーの「無視リスト」を開き、スキップするパスページを開きます。

    • リストに新しいエントリを追加するには、the Add button をクリックするか Alt+Insertを押します。次に the Browse button をクリックして表示されるダイアログで、接続をスキップするファイルまたはフォルダーを選択します。

    • リストからエントリを削除するには、それを選択して the Remove button をクリックするか Alt+Deleteを押します。スクリプトはリクエストを受け取ると実行されます。

  3. スキップするスクリプトへのリクエストを受け取るたびにPhpStormに通知するには、スキップされたパスについて通知するチェックボックスをオンにします。

最終更新日: 2019年11月11日

関連ページ:

Xdebugの設定

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

Zend デバッガーの設定

Zend デバッガーのダウンロードとインストール:お使いのオペレーティングシステムに対応したZend デバッガーパッケージをダウンロードしてください。使用しているPHPのバージョンに対応するディレクトリー(たとえば、4.3.x、4.4.x、5.0.x、5.1.x、5.2.x、5.3.x、5.4)でZ...

PHP

WindowsとLinux用のmacOS用PHPプラグインが有効な場合にのみ、このノードとそのすべてのページを使用できます。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。このページを使用して...

デバッグ

このページを使用して、XdebugとZend デバッガーの動作を設定します。事前構成この領域には、デバッガのインストール、デバッガのクッキーを制御してデバッグセッションを開始/停止するを実行するブックマークレットの生成、およびゼロコンフィギュレーションデバッグの起動に関する簡単なガイドラインが示され...

ブレークポイント

ブレークポイントは、特定の時点でプログラムの実行を中断してその動作を調べるためのソースコードマーカーです。一度設定すると、明示的に削除するまでブレークポイントはプロジェクト内に残ります(一時的な行ブレークポイントを除く)。ブレークポイントを含むファイルが外部で変更された場合、たとえば、VCSを介して...

ブラウザのデバッグ拡張機能

デバッグを開始するには、まずサーバー上でデバッガ・エンジンをアクティブにする必要があります。これを行うには、特別なまたはパラメータを設定する必要があります。(詳細については、XdebugおよびZend デバッガーの公式ドキュメントを参照してください)。手動で行うこともできますが、ブラウザの拡張機能を...