PhpStorm 2026.1 Help

サーバー​

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

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

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

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

項目

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

説明

追加ボタン

追加

Insert

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

削除ボタン

削除

Delete

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

インポートボタン

インポート

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

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

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

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

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

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

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

構成の詳細

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

項目

説明

命名

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

ホスト

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

ポート

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

デバッガー

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

  • Xdebug

  • Zend Debugger

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

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

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

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

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

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

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

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

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

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

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

共用

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

2026 年 5 月 22 日