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

リモート PHP インタープリターの構成

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

SSH、Docker、Docker Compose、Vagrant、または WSL を介してリモート PHP インタープリターにアクセスできます。

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

始める前に:

ターゲットリモートホスト上の ssh サーバーへのアクセスを構成し、このサーバーが稼働していることを確認してください。
PHP リモートインタープリターと FTP/SFTP 接続プラグインが有効になっていることを確認してください。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。
SSH 構成を作成する説明に従って、SSH 構成を作成します。

SSH を使用して PHP インタープリターを構成する

設定 / 環境設定ダイアログ Ctrl+Alt+S で、言語 & フレームワーク | PHP に移動します。
表示される PHP ページで、CLI インタープリターリストの横にあるをクリックします。
表示される CLI インタープリターダイアログで、左側のペインのをクリックして、ポップアップメニューから Docker、Vagrant、VM、WSL、リモートから... を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、SSH メソッドを選択します。
SSH 構成リストから、作成された SSH 構成の 1 つを選択するか、をクリックして、SSH 構成を作成するに従って新しい構成を作成します。
インタープリター構成を使用するには、プロジェクトフォルダー、プロジェクトファイルのコピー先のサーバー上のフォルダー、およびサーバー上のコピーされたデータにアクセスするための URL アドレス間の対応を設定するパスマッピングが必要です。PhpStorm はまず、使用可能なすべてのアプリケーションレベルの構成を処理することにより、パスマッピング自体を取得しようとします。PhpStorm が、選択された SSH 構成で指定されたものと同じホストの構成を検出した場合、これらの構成からのマッピングは自動的にマージされます。このホストの構成が見つからない場合、PhpStorm はパスマッピングが構成されていないことを通知するエラーメッセージを表示します。
問題を修正するには、設定 / 環境設定ダイアログ Ctrl+Alt+S で言語 & フレームワーク | PHP に進みます。パスマッピングフィールドのをクリックし、ローカルフォルダーをサーバー上のフォルダーにマップします。
PHP インタープリターパスフィールドには、選択したリモート開発環境の構成に従って、PHP 実行ファイルの場所を指定します。
- リモートホストの場合、PhpStorm はデフォルトで /usr/bin/php の場所を提案します。
別のフォルダーを指定するには、をクリックし、表示されるダイアログで関連するフォルダーを選択します。PHP のホームディレクトリは、編集のために開いている必要があることに注意してください。
OK をクリックすると、PhpStorm は PHP 実行可能ファイルが実際に指定されたフォルダーに格納されているかどうかをチェックします。
- PHP 実行ファイルが見つからない場合、PhpStorm は、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。
- PHP 実行ファイルが見つかった場合は、CLI インタープリターダイアログに戻り、インストールフォルダーと検出されたバージョンの PHP インタープリターが表示されます。
CLI インタープリターダイアログで、phpinfo の表示をクリックして、PhpStorm に、インストールの詳細と、ロードされた拡張機能および構成済みオプションのリストを含む個別の情報ウィンドウを表示させます。PHP インタープリターダイアログの構成オプションフィールドで指定された追加オプションはリストされていないことに注意してください。

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

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、WSL、リモートから... を選択します。
表示されるリモート 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 に、インストールの詳細と、ロードされた拡張機能および構成済みオプションのリストを含む個別の情報ウィンドウを表示させます。PHP インタープリターダイアログの構成オプションフィールドで指定された追加オプションはリストされていないことに注意してください。
CLI インタープリターダイアログのライフサイクル領域で、選択したサービスの Docker コンテナーを PhpStorm で管理する方法を選択します。
- 常に新しいコンテナーを始める ('docker-compose ラン ') : run(英語) コマンドを使用してコンテナーを起動するには、このオプションを選択します。コンテナーは実行のたびに再起動されます。
- 既存のコンテナーに接続する ('docker-compose exec') : このオプションを選択すると、コンテナーが 1 回開始されてから、exec(英語) コマンドを使用してコンテナーに接続します。

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、WSL、リモートから... を選択します。
表示されるリモート 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 に、インストールの詳細と、ロードされた拡張機能および構成済みオプションのリストを含む個別の情報ウィンドウを表示させます。PHP インタープリターダイアログの構成オプションフィールドで指定された追加オプションはリストされていないことに注意してください。

WSL を使用すると、Windows Subsystem for Linux(英語) 互換性レイヤーを介して、Linux 環境にインストールされた PHP インタープリターにアクセスできます。

開始する前に、次の前提条件が満たされていることを確認してください。

Windows 10 マシンで、WSL 機能が有効になっており、優先 Linux ディストリビューションがインストールされていることを確認してください。詳細については、Windows 10 用 Windows Subsystem for Linux インストールガイド(英語)を参照してください。
Linux インストール内で、PHP がインストールされていることを確認してください。インストール手順の詳細については、Debian GNU / Linux インストールノート(英語)を参照してください。Ubuntu を使用している場合は、ターミナルで次のコマンドを実行して、PHP をすばやくインストールできます。
sudo apt install php php-mbstring php-dom php-xml php-zip php-curl php-xdebug

WSL を使用して PHP インタープリターを構成する

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

追加の構成オプションを提供する

設定 / 環境設定ダイアログ Ctrl+Alt+S で、言語 & フレームワーク | PHP に移動します。
表示される PHP ページで、CLI インタープリターリストの横にあるをクリックします。
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 インタープリターダイアログに戻り、エントリがコマンドラインに変換されます。

カスタムマッピングを構成する

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

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

構成済みの PHP インタープリターをオンザフライで切り替える

Ctrl+Shift+A を押して、Change PHP interpreter と入力し始めます。候補リストで、PHP インタープリターを変更するアクションを選択します。
必要に応じて、Alt+Enter を押して候補リストで直接、またはキーボードショートカットを設定するに従って、このアクションのキーボードショートカットを割り当てることができます。
表示されるポップアップメニューで、構成済みのローカルまたはリモート PHP インタープリターのいずれかを選択します。

選択したインタープリターは、設定 / 環境設定ダイアログ Ctrl+Alt+S の PHP ページでデフォルトのプロジェクトインタープリターとして設定されます。これは、デフォルトのプロジェクトインタープリターを使用するように設定されている実行 / デバッグ構成、テストフレームワーク '、品質ツール構成にも影響します。