PhpStorm 2020.1ヘルプ

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. From the デバッガー list, choose the debugging engine to use.

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

    Path mappings in PHPデバッグサーバー configurations look very similar to the path mappings in server access ( deployment configurations. Unfortunately, they cannot be reused, as deployment configurations uses relative paths while PHPデバッグサーバー configurations rely on absolute paths.

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

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

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

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

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

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

    Debug mappings not configured error message.png

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

    Fixing debug mappings configuration.png

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

  6. Select the Shared checkbox to share the debug server configuration across a team. The host/port settings and the path mappings are stored in the .idea/php.xml file is available to all team members through a version control system. Note that mappings are shared only for directories inside the project.

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

  1. 設定/環境設定ダイアログ Ctrl+Alt+Sで、言語 & フレームワーク | PHP | サーバーに移動します。

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

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

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

  3. デプロイリストから選択したサーバーアクセス構成のタイプに応じて、次のいずれかを指定します。
    • FTPSFTP、またはFTPSサーバーアクセス構成の場合は、サーバーのデプロイルートへの絶対パスを指定します。

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

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

    • For ローカルまたはマウントされたフォルダー , type the absolute path to the server root as specified in the フォルダー field of the デプロイ: 接続タブ dialog.

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

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

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

最終更新日: 2020年5月08日