ツイートシェアはてブ LINE Pocket

リモート PHPインタープリターの設定

リモート PHPインタープリターという用語は、リモートホストまたは仮想環境にインストールされたPHPエンジンを意味します。リモート PHPインタープリターという用語は、コンピューターにインストールされているローカルPHPインタープリターの反対語として使用されます。ローカルPHPインタープリターの設定を参照してください。

リモートインタープリターでの作業を開始する前に、SSH リモートの実行プラグインが有効になっていることを確認してください。プラグインはPhpStormにバンドルされており、デフォルトでアクティブになっています。プラグインがアクティブになっていない場合は、プラグインを管理する説明に従って、設定/環境設定ダイアログのプラグインページ（Ctrl+Alt+S）でプラグインを有効にします。

さらに、PHP リモートインタープリターバンドルプラグインが有効になっていることを確認してください。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインをアクティブにします。

次のいずれかの方法で、リモート PHPインタープリターにアクセスできます。

Vagrant構成を使用すると、対応するVagrantインスタンスにインストールされているPHPインタープリターにアクセスできます。

始める前に：

Vagrantに従って、Vagrant(英語)とOracleのVirtualBox(英語)がコンピューター上でダウンロード、インストール、設定されていることを確認してください。
Vagrantバンドルプラグインが有効になっていることを確認してください。プラグインが無効になっている場合は、プラグインを管理する説明に従って有効にします。
次の実行可能ファイルの親フォルダーがシステムPATH変数に追加されていることを確認します。
- Vagrantからvagrant.bat または vagrant を選択してください。これは、Vagrantインストーラによって自動的に実行されます。
- VBoxManage.exe または VBoxManage を使用してください。
使用するVagrantインスタンスのPHP開発環境を設定します。

VagrantでPhpStormでVagrantを使用する方法の詳細を参照してください。

VagrantインスタンスでPHPインタープリターを設定する

設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語 & フレームワーク | PHPを選択します。
表示されるPHPページで、CLI インタープリターリストの横にあるをクリックします。
表示されるCLI インタープリターダイアログで、左側のペインのをクリックして、ポップアップメニューからDocker、Vagrant、VM、リモートから...を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、Vagrantメソッドを選択します。
接続パラメータを指定します。
- 使用する環境を指すVagrant インスタンス・フォルダーを指定します。技術的には、VagrantFileの環境設定ファイルが置かれているフォルダーです。この設定に基づいて、PhpStormはVagrant ホストを検出し、それをVagrant ホスト URLの読み取り専用フィールドにリンクとして表示します。
  インタープリター構成を使用するには、プロジェクトフォルダー、プロジェクトファイルをコピーするサーバー上のフォルダー、サーバー上のコピーデータにアクセスするためのURLアドレス間の対応関係を設定するパスマッピングが必要です。PhpStormは、VagrantFile 構成ファイルからのパスマッピングを評価します。
PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
- Vagrantインスタンスの場合、デフォルトでPhpStormは /usr/bin/php フォルダーを提案します。
別のフォルダーを指定するには、をクリックし、表示されるダイアログで関連するフォルダーを選択します。PHPのホームディレクトリーは、編集のために開いている必要があることに注意してください。
OKをクリックすると、PhpStormはPHP実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。
- PHP実行ファイルが見つからない場合、PhpStormは、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。
- PHP実行ファイルが見つかった場合は、CLI インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンのPHPインタープリターが表示されます。
CLI インタープリターダイアログでphpinfo の表示をクリックして、PhpStormに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

配備構成を使用すると、リモートデプロイサーバーにインストールされたPHPインタープリターにアクセスできます。このアプローチは、プロジェクトソースをターゲットリモートホスト上のWebサーバーと同期する場合にも役立ちます。

始める前に：

ターゲットリモートホストでsshサーバーが実行されていることと、アクセスを構成済みであることを確認してください。
PHP リモートインタープリターとリモート・ホスト・アクセスプラグインが有効になっていることを確認してください。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。

SFTPサーバーアクセス構成に基づいてリモート PHPインタープリターを構成する

設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語 & フレームワーク | PHPに進みます。
表示されるPHPページで、CLI インタープリターリストの横にあるをクリックします。
表示されるCLI インタープリターダイアログで、左側のペインのをクリックして、ポップアップメニューからDocker、Vagrant、VM、リモートから...を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、配備構成メソッドを選択します。
接続パラメータを指定します。
- 配備構成リストから、PhpStormをターゲットホストに接続するSFTPタイプのサーバーアクセス構成を選択します。選択された構成で指定された設定が正常な接続を保証する場合、PhpStormはターゲットホストのURLアドレスをリンクとしてデプロイ・ホスト URLフィールドに表示します。
  インタープリター構成を使用するには、プロジェクトフォルダーと、プロジェクトファイルをコピーするサーバー上のフォルダーと、サーバー上のコピーされたデータにアクセスするためのURLアドレスとの対応関係を設定するパスマッピングが必要です。デフォルトでは、PhpStormは、選択したサーバーアクセス（デプロイ）構成からパスマッピングを取得します。設定にパスマッピングが含まれていない場合、PhpStormは対応するエラーメッセージを表示します。
  問題を解決するには、ビルド、実行、デプロイノードにあるデプロイページを開き、関連するサーバーアクセス構成を選択し、マッピングタブに切り替えて、ローカルフォルダーをサーバー上のフォルダーにマップし、URLアドレスにアクセスするセクションの説明に従ってサーバー上のフォルダーにローカルフォルダーをマップします。
PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
- リモートホストの場合、デフォルトでPhpStormは /usr/bin/php フォルダーを提案します。
別のフォルダーを指定するには、をクリックし、表示されるダイアログで関連するフォルダーを選択します。PHPのホームディレクトリーは、編集のために開いている必要があることに注意してください。
OKをクリックすると、PhpStormはPHP実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。
- PHP実行ファイルが見つからない場合、PhpStormは、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。
- PHP実行ファイルが見つかった場合は、CLI インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンのPHPインタープリターが表示されます。
CLI インタープリターダイアログでphpinfo の表示をクリックして、PhpStormに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

SSH 資格情報を使用すると、PHPインタープリターがインストールされているホストへのSSHアクセスを介してPHPインタープリターにアクセスできます。

開始する前に、ターゲットリモートホスト上のsshサーバーへのアクセスを構成し、このサーバーが実行されていることを確認してください。

SSH認証情報を使用してPHPインタープリターを設定する

設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語 & フレームワーク | PHPに進みます。
表示されるPHPページで、CLI インタープリターリストの横にあるをクリックします。
表示されるCLI インタープリターダイアログで、左側のペインのをクリックして、ポップアップメニューからDocker、Vagrant、VM、リモートから...を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、 SSH 資格情報メソッドを選択します。
接続パラメータを指定します。
- リモートホストの名前と、SSHサーバーがリッスンするポートを指定します。デフォルトのポート番号は22です。
- リモートホストアクセス認証情報を指定してください。ユーザー名を入力して認証方法を選択します。
  - パスワード : パスワードでホストにアクセスします。パスワードを指定し、パスワードの保存チェックボックスを選択してパスワードをPhpStormに保存します。
  - キー・ペア (OpenSSH または PuTTY) : 鍵ペアと一緒にSSH認証(英語)を使用します。この認証方法を適用するには、クライアントマシンにプライベートキー、リモートサーバーにパブリックキーが必要です。PhpStormは、OpenSSH(英語)ユーティリティで生成された秘密鍵をサポートしています。
    秘密鍵が格納されているファイルへのパスを指定し、対応するフィールドにパスフレーズ（存在する場合）を入力します。PhpStormにパスフレーズを記憶させるには、パスフレーズを保存チェックボックスを選択します。
  - OpenSSHの設定と認証エージェント : 認証情報ヘルパーアプリケーションによって管理されているSSH鍵を使用します（たとえば、Windowsの場合はPageant(英語)、MacおよびLinuxの場合はssh-agent(英語)）。
  インタープリター構成を使用するには、プロジェクトフォルダーと、プロジェクトファイルをコピーするサーバー上のフォルダーと、サーバー上のコピーされたデータにアクセスするためのURLアドレスとの対応関係を設定するパスマッピングが必要です。PhpStormはまず、利用可能なすべてのアプリケーションレベルの設定を処理することによって、パスマッピング自体を取得しようとします。PhpStormが上記で指定したホストと同じホストを持つ設定を検出した場合、ホストフィールドにこれらの設定からのマッピングが自動的にマージされます。このホストの設定が見つからない場合、PhpStormはパスマッピングが設定されていないことを示すエラーメッセージを表示します。
  問題を解決するには、設定/環境設定ダイアログ（Ctrl+Alt+S）で言語 & フレームワーク | PHPに進みます。パス・マッピングフィールドでをクリックし、ローカルフォルダーをサーバー上のフォルダーにマップします。
PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
- リモートホストの場合、デフォルトでPhpStormは /usr/bin/php フォルダーを提案します。
別のフォルダーを指定するには、をクリックし、表示されるダイアログで関連するフォルダーを選択します。PHPのホームディレクトリーは、編集のために開いている必要があることに注意してください。
OKをクリックすると、PhpStormはPHP実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。
- PHP実行ファイルが見つからない場合、PhpStormは、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。
- PHP実行ファイルが見つかった場合は、CLI インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンのPHPインタープリターが表示されます。
CLI インタープリターダイアログでphpinfo の表示をクリックして、PhpStormに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

Docker構成を使用すると、DockerコンテナーにインストールされたPHPインタープリターにアクセスできます。

始める前に：

Docker(英語)がDockerに従って、コンピューターにダウンロード、インストール、設定されていることを確認します。
Dockerの統合およびPHP Dockerプラグインがインストールされ、有効になっていることを確認します。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。
使用するDockerコンテナーのPHP開発環境を設定します。

DockerでPhpStormでDockerを使用する方法の詳細を参照してください。

DockerコンテナーにPHPインタープリターを構成する

設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語 & フレームワーク | PHPに進みます。
表示されるPHPページで、CLI インタープリターリストの横にあるをクリックします。
表示されるCLI インタープリターダイアログで、左側のペインのをクリックして、ポップアップメニューからDocker、Vagrant、VM、リモートから...を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、Dockerメソッドを選択します。
接続パラメータを指定します。
- サーバーフィールドで、使用するDocker構成を指定します。詳細については、Dockerデーモンの接続設定を構成するを参照してください。リストから構成を選択するか、新規...をクリックして、開いたDockerページに新しい構成を作成します。
- イメージ名:フィールドで、使用するベースDockerイメージを指定します。リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、php:latest や php:7.0-cliなどのイメージ名を手動で入力します。後で実行構成を起動すると、Dockerはマシン上で指定されたイメージを検索します。検索が失敗した場合、イメージはDockerレジストリページで指定されたイメージリポジトリからダウンロードされます。
PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
- Dockerコンテナーの場合、デフォルトでPhpStormは php フォルダーを提案します。
OKをクリックすると、PhpStormはPHP実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。
- PHP実行ファイルが見つからない場合、PhpStormは、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。
- PHP実行ファイルが見つかった場合は、CLI インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンのPHPインタープリターが表示されます。
CLI インタープリターダイアログでphpinfo の表示をクリックして、PhpStormに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

Docker Compose構成を使用すると、マルチコンテナーDocker Compose環境で実行されているPHPインタープリターにアクセスできます。

始める前に：

Docker(英語)がDockerに従って、コンピューターにダウンロード、インストール、設定されていることを確認します。
Dockerの統合およびPHP Dockerプラグインがインストールされ、有効になっていることを確認します。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。
使用するDockerコンテナーのPHP開発環境を設定します。

Docker Composeの使用でPhpStormでDocker Composeを使用する方法の詳細を参照してください。

Docker Composeを使ってPHPインタープリターを設定する

設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語 & フレームワーク | PHPに進みます。
表示されるPHPページで、CLI インタープリターリストの横にあるをクリックします。
表示されるCLI インタープリターダイアログで、左側のペインのをクリックして、ポップアップメニューからDocker、Vagrant、VM、リモートから...を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、Docker Composeメソッドを選択します。
接続パラメータを指定します。
- サーバーフィールドで、使用するDocker構成を指定します。詳細については、Dockerデーモンの接続設定を構成するを参照してください。リストから構成を選択するか、新規...をクリックして、開いたDockerページに新しい構成を作成します。
- 構成ファイルフィールドに、使用するdocker-compose(英語)構成ファイルを指定します。プロジェクトルートにある基本構成ファイルがデフォルトで選択されています。別のファイルまたは複数のファイルを選択するには、をクリックし、表示されるDocker Compose構成ファイルダイアログで目的の設定ファイルを選択します。
- サービスリストから、PHP開発環境が設定されているコンテナーに対応するサービスを選択します。
- 必要に応じて、環境変数フィールドに環境変数を指定します(英語)。詳細については、環境変数の使用を参照してください。
PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
- Dockerコンテナーの場合、デフォルトでPhpStormは php フォルダーを提案します。
OKをクリックすると、PhpStormはPHP実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。
- PHP実行ファイルが見つからない場合、PhpStormは、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。
- PHP実行ファイルが見つかった場合は、CLI インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンのPHPインタープリターが表示されます。
CLI インタープリターダイアログでphpinfo の表示をクリックして、PhpStormに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。
CLI インタープリターダイアログのライフサイクル領域で、選択したサービスのDockerコンテナーをPhpStormで管理する方法を選択します。
- 常に新しいコンテナーを始める ('docker-composeラン') : このオプションを選択して、run(英語)コマンドを介してコンテナーを起動します。コンテナーは実行ごとに再起動されます。
- 既存のコンテナーに接続する ('docker-compose exec') : このオプションを選択して、コンテナーを1回起動し、exec(英語)コマンドで接続します。

追加の設定オプションを提供する

必要に応じて、CLI インタープリターダイアログの追加領域で、PHPインストールの設定をカスタマイズすることができます。

デバッガー拡張フィールドに、Xdebugへのパスを指定します。これにより、PhpStormは、php.ini ファイルでそれを無効にした場合に必要なときにXdebugを有効にすることができます（オンデマンドモードで使用するためのXdebugの設定を参照）。
構成オプションフィールドで、-dコマンドラインオプション(英語)を介して渡される一連の構成ディレクティブを作成し、php.ini ファイルに新しいエントリーを追加します。このフィールドで指定されたディレクティブは、PhpStormによって生成されたデフォルトのディレクティブ（ -dxdebug.remote_enable=1 , -dxdebug.remote_host=127.0.0.1 , -dxdebug.remote_port=9001 , -dxdebug.remote_mode=reqなど）をオーバーライドします。
例： -dxdebug.remote_mode=jit ディレクティブを指定すると、デフォルトの -dxdebug.remote_mode=req ディレクティブを上書きし、Xdebugをジャストインタイム (JIT)モードに切り替えます（詳細はJust-In-Timeモードでのデバッグを参照）。
これを行うには、構成オプションフィールドの横にあるをクリックして、表示される構成オプションダイアログにエントリのリストを作成します。
- 新しいエントリを追加するには、をクリックします。リストに追加された新しい行で、名前フィールドと値フィールドにそれぞれ新しい項目の名前とその値を指定します。
  必要な数だけエントリを追加できます。長さが256文字に制限されたコマンドラインに変換されることに注意してください。
- エントリを削除するには、リストからエントリを選択してをクリックします。
- エントリの順序を変更するには、またはをクリックします。
OKをクリックすると、CLI インタープリターダイアログに戻り、エントリがコマンドラインに変換されます。

カスタムマッピングの設定

SFTP接続を介してアクセス可能なインタープリターを使用するか、VagrantインスタンスまたはDockerコンテナーにあるインタープリターを使用する場合、マッピングは対応するデプロイ構成、Vagrantfile、または Dockerfileから自動的に取得されます。

設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語 & フレームワーク | PHPに進みます。
インタープリターリストから、マッピングをカスタマイズしたいリモートインタープリターを選択します。パス・マッピング読み取り専用フィールドは、対応するデプロイ構成、Vagrantfile、または Dockerfileから取得されたパスマッピングを示します。カスタムマッピングを指定するには、パス・マッピングフィールドの横にあるをクリックします。
開いているプロジェクトパスマッピングの編集ダイアログには、デプロイのコンフィギュレーション Vagrantfileまたは Dockerfileから取得したパスマッピングが表示されます。これらのマッピングは読み取り専用です。
- カスタムマッピングを追加するには、をクリックして、プロジェクト内のパスとリモートランタイム環境の対応するパスをそれぞれローカル・パスフィールドとリモート・パスフィールドに指定します。手動でパスを入力するか、をクリックして表示されるダイアログで関連ファイルまたはフォルダーを選択します。
- カスタムマッピングを削除するには、リスト内でカスタムマッピングを選択し、をクリックします。