PhpStorm 2020.3 ヘルプ

PhpStorm でデバッグする: 基本ガイド

このセクションでは、PhpStorm で PHP のデバッグを開始するのに役立つチュートリアルをいくつか紹介します。

クイックスタート

いずれかのデバッグシナリオに進む前に、デバッグエンジンを選択して PHP 環境にインストールする必要があります。これらのチュートリアルでは、インストールプロセスについて説明します。

デバッグエンジンがインストールされている場合、ゼロコンフィギュレーションデバッグアプローチに従ってデバッグを開始できます。

  1. ブラウザーに適したブラウザー拡張機能を選択してインストールします。

  2. PhpStorm ツールバーで、the Start Listening for PHP Debug Connections buttonを切り替えて受信 PHP デバッグ接続の待機を開始するか、メインメニューから実行 | PHP デバッグ接続のリッスンを開始を選択します。

  3. コードにブレークポイントを設定します。ブレークポイントは、PHP , HTML , TWIG , BLADE 内の PHP コンテキストおよび他の種類のファイルに設定できます。行ブレークポイントは実行可能な行にのみ設定できますが、コメント、宣言、または空行には設定できません。Twig と Blade のデバッグの開始についての詳細は、Twig テンプレートをデバッグするBlade テンプレートをデバッグするを参照してください。

  4. ブラウザーの拡張機能を使用して、ブラウザーでデバッグセッションを開始します。

  5. デバッグセッション中に、プログラムの状態を確認します。変数値の確認、式の評価、プログラムのステップ実行などを行います。

PHP Web アプリケーションのデバッグ

環境に応じて、PHP Web アプリケーションをローカルまたはリモートでデバッグできます。

ローカルデバッグ リモートデバッグ
デバッグエンジンと PhpStorm は同じマシンで実行されています。 デバッグエンジンはリモート環境(たとえば、リモートサーバーや仮想マシン)上で実行されています。
ゼロコンフィギュレーションデバッグの手順に従ってください。
  • マシンとリモートサーバーの間に直接接続を確立することができ、リモートサーバーからローカルマシンの特定のポートへの接続をファイアウォール、ルーター、または ISP がブロックしていない場合は、ゼロコンフィギュレーションデバッグの手順に従ってください。

  • それ以外の場合は、直接接続が確立できない場合は、SSH トンネル経由のリモートデバッグの手順に従ってください。

PHP CLI スクリプトのデバッグ

環境に応じて、PHP CLI スクリプトをローカルまたはリモートでデバッグできます。

ローカルデバッグ リモートデバッグ
デバッグエンジンと PhpStorm は同じマシンで実行されています。 デバッグエンジンはリモート環境(たとえば、リモートサーバーや仮想マシン)上で実行されています。
PHP CLI スクリプトをデバッグする手順に従ってください。
  1. リモート PHP インタープリターの構成に従って、リモート PHP インタープリターを設定します。

  2. PHP CLI スクリプトをデバッグする手順に従ってください。

アプリケーション全体を実行するほかに、特定のクラス、関数、またはシナリオをカバーする PHPUnit または Behat テストを実行し、デバッグエンジンをアタッチすることができます。それを行う方法を学ぶには、特定のターゲット用のテスト構成を作成する手順に従ってください。

トラブルシューティング

Xdebug または Zend デバッガーを PhpStorm で使用する場合、いくつかの設定ミスによりデバッガーが機能しなくなる可能性があります。トラブルシューティングガイドでは、いくつかの一般的な課題の説明を見つけ、それらのトラブルシューティング方法を学びます。

高度なデバッグシナリオ

以下のトピックは、PhpStorm の高度なデバッグシナリオの探索に役立ちます。

関連ページ:

Xdebug を構成する

Xdebug をダウンロードPHP バージョンと互換性のあるXdebug 拡張をダウンロードし、インストールガイドの説明に従ってインストールします。Xdebug 3は、パフォーマンスの向上、構成の簡素化、PHP8 のサポートをもたらします。Xdebug 3 へのアップグレードの詳細については、アップ...

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

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

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

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

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、単純な場合(たとえば、コード行に到達したときにプログラムを一時停止する場合)や、より複雑なロジック(追加の条件に対するチェック、ログメッ...

Twig テンプレート

一般的なテンプレートのサポートに加えて、Symfony プラグインは、Twig テンプレート言語に固有の補完、ナビゲーション、コードインスペクションを提供します。Twig テンプレートのコード補完 :エディターで、 を押してコード補完を呼び出し、次のいずれかの操作を行います。どのTWIGファイルでも...

Laravel

Laravelは、無料のオープンソース PHP Web アプリケーションフレームワークです。複数のsymfonyコンポーネントの上に構築され、認証、ルーティング、セッション、キャッシングなどの一般的なタスクを実装するのがはるかに簡単になります。Laravel の使用を開始する前に、Laravel(無...