IntelliJ IDEA 2020.2ヘルプ

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

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

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

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

始める前に:

  • ターゲットリモートホスト上のsshサーバーへのアクセスを構成し、このサーバーが稼働していることを確認してください。

  • SSH構成を作成する説明に従って、SSH構成を作成します。

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

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

  2. 表示されるPHPページで、CLI インタープリターリストの横にある the Browse button をクリックします。

  3. 表示されるCLI インタープリターダイアログで、左側のペインの the Add button をクリックして、ポップアップメニューからDocker、Vagrant、VM、WSL、リモートから...を選択します。

  4. 表示されるリモート PHP インタープリターの構成ダイアログで、SSHメソッドを選択します。

    Remote interpreter via SSH dialog
  5. SSH設定リストから、作成されたSSH構成の1つを選択するか、the Browse button をクリックして、SSH構成を作成するに従って新しい構成を作成します。

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

    問題を修正するには、設定/環境設定ダイアログ Ctrl+Alt+S言語 & フレームワーク | PHPに進みます。パス・マッピングフィールドの Open をクリックし、ローカルフォルダーをサーバー上のフォルダーにマップします。

  6. PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
    • リモートホストの場合、IntelliJ IDEAはデフォルトで/usr/bin/phpの場所を提案します。

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

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

    • PHP実行ファイルが見つからない場合、IntelliJ IDEAはインタープリター設定を検索し続けるか保存するかを確認するエラーメッセージを表示します。

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

  7. CLI インタープリターダイアログでphpinfo の表示 Show phpinfo button をクリックして、IntelliJ IDEAに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

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

始める前に:

  1. Docker(英語)Dockerに従って、コンピューターにダウンロード、インストール、設定されていることを確認します。

  2. DockerおよびPHP Dockerプラグインがインストールされ、有効になっていることを確認します。プラグインはIntelliJ IDEAにバンドルされていませんが、JetBrainsリポジトリからプラグインをインストールするに従って設定/環境設定 | プラグインページにインストールできます。プラグインを有効にすると、IDEレベルで使用できるようになります。つまり、すべてのIntelliJ IDEAプロジェクトでプラグインを使用できます。

  3. 使用するDockerコンテナーのPHP開発環境を設定します。

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

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

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

  2. 表示されるPHPページで、CLI インタープリターリストの横にある the Browse button をクリックします。

  3. 表示されるCLI インタープリターダイアログで、左側のペインの the Add button をクリックして、ポップアップメニューからDocker、Vagrant、VM、WSL、リモートから...を選択します。

  4. 表示されるリモート PHP インタープリターの構成ダイアログで、Dockerメソッドを選択します。

    Remote interpreter via Docker dialog
  5. 接続パラメータを指定します。

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

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

  6. PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
    • Dockerコンテナーの場合、IntelliJ IDEAはデフォルトでphpの場所を提案します。

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

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

    • PHP実行ファイルが見つからない場合、IntelliJ IDEAはインタープリター設定を検索し続けるか保存するかを確認するエラーメッセージを表示します。

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

  7. CLI インタープリターダイアログでphpinfo の表示 Show phpinfo button をクリックして、IntelliJ IDEAに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

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

始める前に:

  1. Docker(英語)Dockerに従って、コンピューターにダウンロード、インストール、設定されていることを確認します。

  2. DockerおよびPHP Dockerプラグインがインストールされ、有効になっていることを確認します。プラグインはIntelliJ IDEAにバンドルされていませんが、JetBrainsリポジトリからプラグインをインストールするに従って設定/環境設定 | プラグインページにインストールできます。プラグインを有効にすると、IDEレベルで使用できるようになります。つまり、すべてのIntelliJ IDEAプロジェクトでプラグインを使用できます。

  3. 使用するDockerコンテナーのPHP開発環境を設定します。

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

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

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

  2. 表示されるPHPページで、CLI インタープリターリストの横にある the Browse button をクリックします。

  3. 表示されるCLI インタープリターダイアログで、左側のペインの the Add button をクリックして、ポップアップメニューからDocker、Vagrant、VM、WSL、リモートから...を選択します。

  4. 表示されるリモート PHP インタープリターの構成ダイアログで、Docker Composeメソッドを選択します。

    Remote interpreter via Docker Compose dialog
  5. 接続パラメータを指定します。

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

    • 構成ファイルフィールドに、使用するdocker-compose(英語)構成ファイルを指定します。プロジェクトルートにある基本構成ファイルがデフォルトで選択されています。別のファイルまたは複数のファイルを選択するには、Open をクリックし、表示されるDocker Compose構成ファイルダイアログで目的の設定ファイルを選択します。

    • サービスリストから、PHP開発環境が設定されているコンテナーに対応するサービスを選択します。

    • 必要に応じて、環境変数フィールドに環境変数を指定します(英語)。詳細については、環境変数の使用を参照してください。

  6. PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
    • Dockerコンテナーの場合、IntelliJ IDEAはデフォルトでphpの場所を提案します。

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

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

    • PHP実行ファイルが見つからない場合、IntelliJ IDEAはインタープリター設定を検索し続けるか保存するかを確認するエラーメッセージを表示します。

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

  7. CLI インタープリターダイアログでphpinfo の表示 Show phpinfo button をクリックして、IntelliJ IDEAに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

  8. CLI インタープリターダイアログのライフサイクル領域で、選択したサービスのDockerコンテナーをIntelliJ IDEAで管理する方法を選択します。
    • 常に新しいコンテナーを始める ('docker-composeラン') : このオプションを選択すると、run(英語)コマンドを使用してコンテナーが開始されます。コンテナーは実行ごとに再起動されます。

    • 既存のコンテナーに接続する ('docker-compose exec') : このオプションを選択すると、コンテナーが1回起動され、exec(英語)コマンドを使用してコンテナーに接続します。

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

始める前に:

  1. Vagrantに従って、Vagrant(英語)OracleのVirtualBox(英語)がコンピューター上でダウンロード、インストール、設定されていることを確認してください。

  2. Vagrantプラグインがインストールされ、有効になっていることを確認します。VagrantプラグインはIntelliJ IDEAにバンドルされていませんが、JetBrainsリポジトリからプラグインをインストールするに従って設定/環境設定 | プラグインページにインストールできます。

  3. 次の実行可能ファイルの親フォルダーがシステムPATH 変数に追加されていることを確認します。
    • Vagrantインストールからのvagrant.batまたは浮浪者。これは、Vagrantインストーラーによって自動的に行われます。

    • OracleのVirtualBoxインストールからのVBoxManage.exeまたはVBoxManage

  4. 使用するVagrantインスタンスのPHP開発環境を設定します。

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

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

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

  2. 表示されるPHPページで、CLI インタープリターリストの横にある the Browse button をクリックします。

  3. 表示されるCLI インタープリターダイアログで、左側のペインの the Add button をクリックして、ポップアップメニューからDocker、Vagrant、VM、WSL、リモートから...を選択します。

  4. 表示されるリモート PHP インタープリターの構成ダイアログで、Vagrantメソッドを選択します。

    Remote interpreter via Vagrant dialog
  5. 接続パラメータを指定します。

    • 使用する環境を指すVagrant インスタンス・フォルダーを指定します。技術的には、VagrantFileの環境設定ファイルが置かれているフォルダーです。この設定に基づいて、IntelliJ IDEAはVagrant ホストを検出し、 Vagrant ホスト URL の読み取り専用フィールドにリンクとして表示します。

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

  6. PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
    • Vagrantインスタンスの場合、デフォルトでIntelliJ IDEAは/usr/bin/php の場所を提案します。

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

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

    • PHP実行ファイルが見つからない場合、IntelliJ IDEAはインタープリター設定を検索し続けるか保存するかを確認するエラーメッセージを表示します。

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

  7. CLI インタープリターダイアログでphpinfo の表示 Show phpinfo button をクリックして、IntelliJ IDEAに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

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インタープリターを構成する

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

  2. 表示されるPHPページで、CLI インタープリターリストの横にある the Browse button をクリックします。

  3. 表示されるCLI インタープリターダイアログで、左側のペインの the Add button をクリックして、ポップアップメニューからDocker、Vagrant、VM、WSL、リモートから...を選択します。

  4. 表示されるリモート PHP インタープリターの構成ダイアログで、WSLメソッドを選択します。

    Remote interpreter via WSL dialog
  5. Linuxディストリビューションリストから、使用するインストール済みLinuxディストリビューションの1つを選択します。

  6. PHP インタープリター・パスフィールドには、選択したリモート開発環境の構成に従って、PHP実行ファイルの場所を指定します。
    • WSLの場合、IntelliJ IDEAはデフォルトで/usr/local/bin/phpを提案します。

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

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

    • PHP実行ファイルが見つからない場合、IntelliJ IDEAはインタープリター設定を検索し続けるか保存するかを確認するエラーメッセージを表示します。

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

  7. CLI インタープリターダイアログでphpinfo の表示 Show phpinfo button をクリックして、IntelliJ IDEAに、インストールの詳細とロードされた拡張機能および構成されたオプションのリストを含む別の情報ウィンドウを表示させます。CLI インタープリターダイアログの構成オプションフィールドに指定された追加オプションはリストされていないことに注意してください。

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

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

  2. 表示されるPHPページで、CLI インタープリターリストの横にある the Browse button をクリックします。

  3. CLI インタープリターダイアログの追加エリアで、PHPインストールの構成設定をオプションでカスタマイズできます。

    • デバッガー拡張フィールドで、Xdebugへのパスを指定します。これにより、 php.ini ファイルでXdebugを無効にした場合に必要なときに、IntelliJ IDEAがXdebugをアクティブ化できるようになります。オンデマンドモードで使用するためのXdebugの設定を参照してください。

    • 構成オプションフィールドで、-dコマンドラインオプション(英語)を介して渡される一連の構成ディレクティブを作成し、php.iniファイルに新しいエントリーを追加します。このフィールドで指定されたディレクティブは、IntelliJ IDEAによって生成されたデフォルトのディレクティブ( -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モードでのデバッグを参照)。

      これを行うには、構成オプションフィールドの横にある the Browse button をクリックして、表示される構成オプションダイアログにエントリのリストを作成します。

      • 新しいエントリを追加するには、the Add buttonをクリックします。リストに追加された新しい行で、名前フィールドとフィールドにそれぞれ新しい項目の名前とその値を指定します。

        必要な数だけエントリを追加できます。長さが256文字に制限されたコマンドラインに変換されることに注意してください。

      • エントリを削除するには、リストからエントリを選択して the Remove buttonをクリックします。

      • エントリの順序を変更するには、the Up button または the Down buttonをクリックします。

      OKをクリックすると、CLI インタープリターダイアログに戻り、エントリがコマンドラインに変換されます。

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

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

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

  2. インタープリターリストから、マッピングをカスタマイズするリモートインタープリターを選択します。パス・マッピング読み取り専用フィールドには、対応するデプロイ構成、悪影響ファイルまたはDockerfileから取得されたパスマッピングが表示されます。カスタムマッピングを指定するには、パス・マッピングフィールドの横にある the Browse button をクリックします。

  3. プロジェクトパスマッピングの編集ダイアログには、デプロイ構成、悪影響ファイル、またはDockerfileから取得したパスマッピングが表示されます。これらのマッピングは読み取り専用です。

    • カスタムマッピングを追加するには、the Add button をクリックして、プロジェクト内のパスとリモートランタイム環境の対応するパスをそれぞれローカル・パスフィールドとリモート・パスフィールドに指定します。手動でパスを入力するか、the Browse button をクリックして表示されるダイアログで関連ファイルまたはフォルダーを選択します。

    • カスタムマッピングを削除するには、リスト内でカスタムマッピングを選択し、the Remove buttonをクリックします。

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

  1. Ctrl+Shift+A を押して、Change PHP interpreterと入力し始めます。候補リストで、 PHPインタープリターを変更する アクションを選択します。

    必要に応じて、Alt+Enterを押して候補リストで直接、またはキーボードショートカットの構成に従って、このアクションのキーボードショートカットを割り当てることができます。

  2. 表示されるポップアップメニューで、設定済みのローカルまたはリモート PHPインタープリターのいずれかを選択します。

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

Switching the PHP interpreter
最終更新日: 2020年9月03日

関連ページ:

ローカルPHPインタープリターの構成

以下は、PHPプラグインがインストールされ使用可能になっている場合にのみ有効です。ローカルPHPインタープリターは、リモート PHPインタープリターの反対側にコンピューターにインストールされたPHPエンジンであり、リモートホストまたはVagrantインスタンスに設定された仮想環境にインストールできま...

Docker

Dockerを使用すると、開発者は本番環境と同じ環境でコードをテストするために、コンテナー内にアプリケーションをデプロイできます。IntelliJ IDEAは、Dockerプラグインを使用してDockerサポートを提供します。プラグインはIntelliJ IDEA Ultimateエディションにバン...

プラグインを管理する

プラグインはIntelliJ IDEAのコア機能を拡張します。彼ら:バージョン管理システム、アプリケーションサーバー、およびその他のツールとの統合を提供する、さまざまな言語とフレームワークのコーディング支援サポートを追加する、ショートカットヒント、ライブプレビュー、ファイルウォッチャーなどで生産性を...

Vagrant

IntelliJ IDEAはVagrantと統合され、悪影響ファイル構成ファイルで定義された再現可能な開発環境の作成を支援します。仮想ボックスの作成と削除、Vagrantボックスの初期化、Vagrant構成ファイルから設定を読み取ることによるリモートインタープリターの構成、およびIDEを移動せずに他...

Xdebugを構成する

以下は、PHPプラグインがインストールされ使用可能になっている場合にのみ有効です。XdebugをダウンロードPHPのバージョンと互換性のあるXdebug拡張をダウンロードし、インストールガイドの説明に従ってインストールします。AMPパッケージを使用している場合、Xdebug拡張機能が既にインストール...

キーボードショートカットの構成

IntelliJ IDEAには定義済みのキーマップがいくつか含まれており、頻繁に使用するショートカットをカスタマイズできます。キーマップ構成を表示するには、設定/環境設定ダイアログ を開き、キーマップを選択します。IntelliJ IDEAは、環境に基づいて事前定義されたキーマップを自動的に提案し...