PhpStorm 2025.3 ヘルプ

サーバー

このページでは、デバッグエンジンがローカルサーバーおよびリモート Web サーバーと対話するための HTTP アクセスを構成し、サーバー上のファイルと PhpStorm プロジェクト内のローカルコピー間の対応を設定します。

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

ツールバーと一般的なオプション

ツールバーのボタンを使用して、構成のリストを管理します。

項目

ツールチップとショートカット

説明

the Add button

追加

Insert

新しい構成を定義するには、このボタンをクリックします。

the Remove button

削除

Delete

選択した設定をリストから削除するには、このボタンをクリックします。

the Import button

インポート

このボタンをクリックしてデプロイ構成からのインポートダイアログダイアログを開きます。このダイアログでは、サーバー上のアプリケーションにアクセスするための構成を選択し、そこからホストとポートの設定を使用します。

ダイアログには、デプロイ構成から取得したパスマッピングも表示されます。サーバー上の相対パスを絶対パスに変換する必要があります。

  • FTPSFTPFTPS サーバーアクセス構成では、サーバーデプロイルートへの絶対パスを指定します。このパスは、デプロイ: 接続タブルートパスフィールドからパスへの接頭辞として追加されます。

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

  • タイプローカルまたはマウント済みフォルダーのサーバーアクセス構成の場合は、サーバーのドキュメントルートまたはマウントされたフォルダーの絶対パスを指定します。このパスは、デプロイ: 接続タブフォルダーフィールドで指定されたパスでなければなりません。

  • Inplace Server 構成では、ローカルパスとリモートパスが同じであるため、マッピングは不要です。

詳細は、Web サーバーに接続するを参照してください。

構成の詳細

この領域では、デバッグセッション中に使用される接続パラメーターとマッピングを指定します。

項目

説明

名前

このフィールドに、PHP_IDE_CONFIG または $_SERVER 環境変数で構成されているサーバーの名前を入力します。

ホスト

このフィールドに、ターゲットアプリケーションがデプロイされているホストの名前を入力します。

ポート

このフィールドに、指定したホストに接続するためのポートを入力します。マシンで localhost を使用している場合、この設定は、アプリケーションが実行またはデバッグされるローカル Web サーバーの構成ファイルで指定されているポートに対応している必要があります。

デバッガー

このリストから、使用するデバッグエンジンを選択します。利用可能なオプションは以下のとおりです。

  • Xdebug

  • Zend デバッガー

パスマッピングを使用する

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

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

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

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

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

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

Debug mappings not configured error message.png

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

Fixing debug mappings configuration.png

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

共用

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

2025 年 4 月 02 日

関連ページ:

デプロイ構成からのインポートダイアログ

ダイアログは、PHP および FTP/SFTP/WebDAV 接続プラグインが有効になっている場合にのみ使用できます。プラグインは PhpStorm にバンドルされていませんが、JetBrains マーケットプレイスからプラグインをインストールするに従って設定 | プラグインページにインストールできます。プラグインを有効にすると、IDE レベルで使用できるようになります。つまり、すべての PhpStorm プロジェクトでプラグインを使用できます。サーバーページのツールバーでクリックすると、ダイアロ...

デプロイ: 接続タブ

このタブを使用して、Web サーバーにアクセスする方法を選択し、接続設定を指定します。コントロールのセットは、選択したサーバーアクセスタイプによって異なります。すべてのサーバータイプに共通の設定:このプロジェクトでのみ表示するこのチェックボックスを使用すると、このサーバーアクセス構成またはサーバーグループを他のプロジェクトで再利用できるようになります。チェックボックスを選択して、構成またはサーバーグループの使用を現在のプロジェクトに制限します。このような構成またはサーバーグループは、現在のプロ...

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

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