PhpStorm 2026.3 Help

PHP デバッグサーバー構成を作成する

PHP デバッグサーバーの設定という用語は、デバッグエンジンがローカルサーバーおよびリモート Web サーバー上の PHP インタープリターと対話し、サーバー上のファイルと PhpStorm プロジェクト内のローカルコピー間の対応を設定するために HTTP アクセスを確保する設定を示します。

デバッグサーバー構成の設定は、 PHP Web ページまたは PHP リモートデバッグタイプの実行 / デバッグ構成を使用してデバッグする場合、および ゼロ構成デバッグセッション中に使用されます。

デバッグサーバー構成を最初から手動で作成することも、サーバーアクセス (デプロイ) 構成から一部の設定をインポートすることもできます。 詳細は、 Karma を参照してください。

デバッグサーバー設定を手動で定義する

  1. 設定 ダイアログ(Ctrl+Alt+S )で PHP | サーバー に移動します。

    または、 PHP Web ページダイアログの Server リストの横にある 参照ボタン をクリックします。

    どちらの場合でも、 サーバーページが開き、左側のペインに使用可能なすべてのデバッグサーバー構成が表示されます。 ツールバーの 追加ボタン をクリックし、右側のペインにデバッグサーバー設定を指定します。

  2. デバッグサーバーの構成名を指定します。

  3. アプリケーションが実行されるホストとそれにアクセスするポートを指定します。

  4. デバッガー リストから、使用する デバッグエンジンを選択します。

  5. PhpStorm がサーバー上のファイルとローカルコピー間の対応を設定する方法を指定します。 これらのマッピングに基づいて、PhpStorm は現在処理されているファイルのローカルコピーを開きます。

    PHP デバッグサーバー構成のパスマッピングは、サーバーアクセス (デプロイ )構成のパスマッピングと非常によく似ています。 残念ながら、デプロイ構成は相対パスを使用しますが、 PHP デバッグサーバー構成は絶対パスに依存するため、これらを再利用することはできません。

    • リモート Web サーバーで作業している場合、つまり Web サーバーが物理的にリモートホストにある場合、または Web サーバーがマシンにインストールされているがプロジェクトが Web サーバードキュメントルートの外側にある場合は、 パスマッピングを使用する チェックボックスを選択します。 シンボリックリンクを使用している場合は、このチェックボックスも選択してください。

      サーバー上の絶対パス および ファイル / ディレクトリ フィールドをそれぞれ使用して、ローカルファイルシステム内のプロジェクトファイルへの絶対パスを使用して、サーバー上のファイルおよびフォルダーへの絶対パスをマップします。

      • ファイル / ディレクトリ この読み取り専用フィールドには、現在のプロジェクトのファイルとフォルダーが表示されます。 ローカルコピーとして使用するファイルまたはフォルダーを選択します。

      • サーバー上の絶対パス このフィールドには、選択したローカルファイルまたはフォルダーが対応するターゲットサーバー上のファイルまたはフォルダーへの絶対パスを指定します。 パスを手動で入力するか、リストから選択します。

    • プロジェクトルートがサーバーのドキュメントルートにくるように Web サーバー上で作業している場合は、 パスマッピングを使用する チェックボックスをオフにします。 この場合、Web サーバー上のファイルへの絶対パスとプロジェクト内の対応するファイルへの絶対パスは同じです。

    パスのマッピングを指定せずに、サーバーのドキュメントルートにないアプリケーションのデバッグを開始すると、PhpStorm はエラーメッセージを表示します。

    デバッグマッピングが設定されていません error message.png

    クリックしてパスマッピングを設定する リンクをクリックすると パスマッピングの問題を解決する ダイアログが表示され、パスマッピングを定義できます。

    デバッグマッピングの修正 configuration.png

    OK をクリックしてダイアログを閉じると、 サーバー ページの パスマッピングを使用する チェックボックスが自動的に選択されます。

  6. 共有チェックボックスを選択すると、チーム全体でデバッグサーバー構成を共有できます。 .idea/php.xml ファイルに格納されているホスト / ポートの設定とパスのマッピングは、バージョン管理システムを介してすべてのチームメンバーが利用できます。 マッピングは、プロジェクト内のディレクトリに対してのみ共有されることに注意してください。

サーバーアクセス(デプロイ)構成から設定をインポートする

  1. 設定 ダイアログ(Ctrl+Alt+S )で PHP | サーバー に移動します。

    または、 PHP Web ページダイアログの Server リストの横にある 参照ボタン をクリックします。

    どちらの場合でも、 サーバーページが開き、左側のペインに使用可能なすべてのデバッグサーバー構成が表示されます。 ツールバーの the Import button をクリックします。 デプロイ構成からのインポートダイアログ ダイアログが開きます。

  2. デプロイ リストから、サーバーアクセス設定(デプロイ設定)を選択して、サーバーアクセス設定をコピーします。 このリストには、使用可能なすべてのデプロイ構成が含まれています。 新しい設定を作成するには、 参照ボタン をクリックし、表示される デプロイ: 接続タブダイアログで新しい設定を指定します。

  3. デプロイ リストから選択したサーバーアクセス構成のタイプに応じて、次のいずれかを指定します。

    • FTP、 SFTP、 FTPS サーバーアクセス構成では、サーバーデプロイルートへの絶対パスを指定します。

      このパスは、 デプロイ: 接続タブの ルートパス フィールドからのパスの接頭辞として追加されます。

      この絶対パスがわからない場合は、 リモートホスト ツールウィンドウを開き、必要なデプロイ構成を選択し、ルートフォルダーにキャレットを置き、コンテキストメニューから パスのコピー を選択します。 詳細については、「Web サーバーに接続する 」を参照してください。 または、ホスティングプロバイダーにお問い合わせください。

    • ローカルまたはマウント済みフォルダーの場合は、 デプロイ: 接続タブダイアログの フォルダー フィールドで指定されている サーバールートへの絶対パスを入力します。

    • Inplace Server 構成では、この場合はローカルパスとリモートパスが同じであるため、マッピングは必要ありません。

  4. Preview 領域には、選択したサーバーアクセス構成(デプロイ構成)から取得したホスト / ポートとパスマッピングが表示されます。

    使用するデプロイ構成を選択すると、 サーバー上の絶対パス フィールドには、選択した構成のプロジェクトファイルおよびフォルダーにマップされた相対パス、つまりデプロイルートに相対的なファイルおよびフォルダーへのパスが表示されます。 デプロイルート(FTP/SFTP/FTPS/WebDAV またはマウントされたフォルダーのサーバールート)への絶対パスを指定すると、フィールドの内容が自動的に更新され、最後にフィールドにサーバー上の絶対パスが表示されます。

2026 年 11 月 9 日