PHP リモートインタープリターの構成ダイアログ

SSH

SSH 認証情報を介してリモートホスト上の PHP インタープリターへのアクセスを構成するには、このオプションを選択します。SSH 構成リストから、作成された SSH 構成の 1 つを選択するか、 をクリックして、SSH 構成を作成する説明に従って新しい構成を作成します。

インタープリター構成を使用するには、プロジェクトフォルダー、プロジェクトファイルのコピー先のサーバー上のフォルダー、サーバー上のコピーされたデータにアクセスするための URL アドレス間の対応を設定するパスマッピングが必要です。PhpStorm はまず、使用可能なすべてのアプリケーションレベルの構成を処理することにより、パスマッピング自体を取得しようとします。PhpStorm が、選択された SSH 構成で指定されたものと同じホストの構成を検出した場合、これらの構成からのマッピングは自動的にマージされます。このホストの構成が見つからない場合、PhpStorm はパスマッピングが構成されていないことを通知するエラーメッセージを表示します。

この問題を解決するには、ビルド、実行、デプロイノードのデプロイページを開き、サーバーアクセス設定を選択し、マッピングタブに切り替え、リモートサーバー構成を作成する、セクションローカルフォルダーをサーバー上のフォルダーにマップし、それらにアクセスするための URL アドレスの説明に従ってローカルフォルダーをサーバー上のフォルダーにマップします。

Docker

このオプションは、PHP Docker および Docker プラグインが有効になっている場合にのみ使用できます。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインのインストールの説明に従って、プラグインページのインストール済みタブでプラグインを有効にします。

Docker コンテナーで動作する PHP インタープリターへのアクセスを設定するには、このオプションを選択します。ダイアログのフィールドで、以下を指定します。

• サーバーフィールドに、使用する Docker の設定を指定します。詳細については、Docker デーモンの接続設定を構成するを参照してください。リストから構成を選択するか、新規 ... をクリックして、開いた Docker ページ上に新しい構成を作成します。

• イメージ名: フィールドで、使用するベース Docker イメージを指定します。リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、php:latest や php:7.0-cli などのイメージ名を手動で入力します。後で実行構成を起動すると、Docker はマシン上で指定されたイメージを検索します。検索が失敗した場合、イメージは Docker レジストリページの Docker 公式イメージ(英語)リポジトリからダウンロードされます。

Docker Compose

このオプションは、PHP Docker および Docker プラグインが有効になっている場合にのみ使用できます。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインのインストールの説明に従って、プラグインページのインストール済みタブでプラグインを有効にします。

マルチコンテナーアプリケーションの Docker コンテナーで動作する PHP インタープリターへのアクセスを設定するには、このオプションを選択します。ダイアログのフィールドで、以下を指定します。

• サーバーフィールドに、使用する Docker の設定を指定します。詳細については、Docker デーモンの接続設定を構成するを参照してください。リストから構成を選択するか、新規 ... をクリックして、開いた Docker ページ上に新しい構成を作成します。

• 構成ファイルフィールドに、アプリケーションのサービスを定義する docker-compose.yml ファイル(英語)を指定します。

• サービスフィールドで、目的のアプリケーションのサービスを選択します。

• 必要に応じて、環境変数フィールドで環境変数を定義します。詳細については、Docker Compose 実行構成設定を参照してください。

PHP インタープリターパス

このフィールドには、選択したリモート開発環境の構成に従って、PHP 実行ファイルの場所を指定します。

• リモートホストの場合、PhpStorm はデフォルトで /usr/bin/php の場所を提案します。

• Vagrant インスタンスの場合、デフォルトで PhpStorm は /usr/bin/php の場所を提案します。

• Docker コンテナーの場合、デフォルトで PhpStorm は php の場所を提案します。

別のフォルダーを指定するには、 をクリックし、表示されるダイアログで関連するフォルダーを選択します。PHP のホームディレクトリは、編集のために開いている必要があることに注意してください。

OK をクリックすると、PhpStorm は PHP 実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。

• PHP 実行ファイルが見つからない場合、PhpStorm は、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。

• PHP 実行ファイルが見つかった場合は、インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンの PHP インタープリターが表示されます。

Vagrant

このオプションは、Vagrant リポジトリプラグインがインストールされ、有効になっている場合にのみ使用できます。Vagrant プラグインは PhpStorm にバンドルされていませんが、JetBrains マーケットプレイスからプラグインをインストールするに従って、設定 | プラグインページのタブマーケットプレースにインストールできます。

Vagrant の資格情報を使用して Vagrant インスタンスにインストールされた PHP インタープリターへのアクセスを設定するには、このオプションを選択します。技術的には、VagrantFile の環境設定ファイルが置かれているフォルダーです。この設定に基づいて、PhpStorm は Vagrant ホストを検出し、それを Vagrant ホスト URL read-only フィールドのリンクとして表示します。

インタープリター構成を使用するには、プロジェクトフォルダー、プロジェクトファイルをコピーするサーバー上のフォルダー、サーバー上のコピーデータにアクセスするための URL アドレス間の対応関係を設定するパスマッピングが必要です。PhpStorm は、VagrantFile 構成ファイルからのパスマッピングを評価します。