PhpStorm 2025.2 ヘルプ

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

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

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

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

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

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

    または、PHP Web ページダイアログのサーバーリストの横にある the Browse button をクリックします。

    いずれの場合も、サーバーページが開き、使用可能なすべてのデバッグサーバー設定が左側のペインに表示されます。ツールバーの the Add button をクリックし、右側のペインにデバッグサーバー設定を指定します。

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

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

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

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

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

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

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

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

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

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

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

    Debug mappings not configured error message.png

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

    Fixing debug mappings configuration.png

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

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

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

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

    または、PHP Web ページダイアログのサーバーリストの横にある the Browse button をクリックします。

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

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

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

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

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

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

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

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

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

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

2024 年 6 月 28 日

関連ページ:

Web サーバーに接続する

PhpStorm は、次の 3 種類の「ローカル開発 — デプロイサーバー」構成を区別します。インプレースサーバー構成。インプレースサーバー構成では、ローカル Web サーバーを使用しますが、ローカルサーバー構成とは異なり、サーバーのファイル構造内の PhpStorm プロジェクトとプロジェクトフォルダー間でファイルのアップロード / ダウンロードや同期は行いません。代わりに、PhpStorm でサーバーのドキュメントルートからプロジェクトフォルダーを直接開き、サーバー上で直接開発を行います。イン...

サーバー

このページでは、デバッグエンジンがローカルサーバーおよびリモート Web サーバーと対話するための HTTP アクセスを構成し、サーバー上のファイルと PhpStorm プロジェクト内のローカルコピー間の対応を設定します。デバッグサーバー構成の設定は、PHP Web ページまたは PHP リモートデバッグタイプの実行 / デバッグ構成を使用してデバッグする場合、およびゼロ構成デバッグセッション中に使用されます。ツールバーと一般的なオプション:ツールバーのボタンを使用して、構成のリストを管理する...

除外されたファイルとフォルダー

単一ファイルを除外するインスペクション、コード補完などによって無視されるように、プロジェクトから単一のファイルを除外する必要がある場合があります。これはファイルタイプのオーバーライドアクションを使用して行われます。プロジェクトツールウィンドウで、目的のファイルを選択します。選択したコンテキストメニューからを選択し、ファイルタイプの選択リストからプレーンテキストを選択します。<ファイルタイプ> としてマークアクションを使用してファイルを元のタイプに戻すこともできます。ファイルがプレーン...