リモート 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 ページで、CLI インタープリターリストの横にある
をクリックします。
表示される CLI インタープリターダイアログで、左側のペインの
をクリックして、ポップアップメニューから Docker、Vagrant、VM、WSL、リモートから... を選択します。
表示されるリモート PHP インタープリターの構成ダイアログで、SSH メソッドを選択します。
SSH 構成リストから、作成された SSH 構成の 1 つを選択するか、
をクリックして、SSH 構成を作成するに従って新しい構成を作成します。
インタープリター構成を使用するには、プロジェクトフォルダー、プロジェクトファイルのコピー先のサーバー上のフォルダー、およびサーバー上のコピーされたデータにアクセスするための URL アドレス間の対応を設定するパスマッピングが必要です。PhpStorm はまず、使用可能なすべてのアプリケーションレベルの構成を処理することにより、パスマッピング自体を取得しようとします。PhpStorm が、選択された SSH 構成で指定されたものと同じホストの構成を検出した場合、これらの構成からのマッピングは自動的にマージされます。このホストの構成が見つからない場合、PhpStorm はパスマッピングが構成されていないことを通知するエラーメッセージを表示します。
問題を修正するには、設定 / 環境設定ダイアログ Ctrl+Alt+S で に進みます。パスマッピングフィールドの
をクリックし、ローカルフォルダーをサーバー上のフォルダーにマップします。
- 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 ページで、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 ページで、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 で管理する方法を選択します。
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 ページで、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 ページで、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 ページで、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 で、 に移動します。
インタープリターリストから、マッピングをカスタマイズしたいリモートインタープリターを選択します。パスマッピング読み取り専用フィールドは、対応するデプロイ構成、Vagrantfile、または Dockerfile から取得されたパスマッピングを示します。カスタムマッピングを指定するには、パスマッピングフィールドの横にある
をクリックします。
プロジェクトパスマッピングの編集ダイアログには、デプロイ構成、Vagrantfile、または Dockerfile から取得したパスマッピングが表示されます。これらのマッピングは読み取り専用です。
カスタムマッピングを追加するには、
をクリックして、プロジェクト内のパスとリモートランタイム環境の対応するパスをそれぞれローカルパスフィールドとリモートパスフィールドに指定します。手動でパスを入力するか、
をクリックして表示されるダイアログで関連ファイルまたはフォルダーを選択します。
カスタムマッピングを削除するには、リスト内でカスタムマッピングを選択し、
をクリックします。
構成済みの PHP インタープリターをオンザフライで切り替える
Ctrl+Shift+A を押して、
Change PHP interpreter
と入力し始めます。候補リストで、PHP インタープリターを変更するアクションを選択します。必要に応じて、Alt+Enter を押して候補リストで直接、またはキーボードショートカットを設定するに従って、このアクションのキーボードショートカットを割り当てることができます。
選択したインタープリターは、設定 / 環境設定ダイアログ Ctrl+Alt+S の PHP ページでデフォルトのプロジェクトインタープリターとして設定されます。これは、デフォルトのプロジェクトインタープリターを使用するように設定されている実行 / デバッグ構成、テストフレームワーク '、品質ツール構成にも影響します。

関連ページ:

ローカル PHP インタープリターを構成する
ローカル PHP インタープリターは、リモート PHP インタープリターの反対側にコンピューターにインストールされる PHP エンジンであり、リモートホストまたは Vagrant インスタンスにセットアップされた仮想環境にインストールできます。リモート PHP インタープリターの構成を参照してください。設定 / 環境設定ダイアログで、に移動します。表示される PHP ページで、CLI インタープリターリストの横にあるをクリックします。表示される CLI インタープリターダイアログで、左側のペインのをク...

プラグインを管理する
このサイトのメニューやアクション名表記は日本語です。PhpStorm を日本語化するには、日本語言語パックのインストールを参照してください。プラグインは以下に示すように PhpStorm のコア機能を拡張します。バージョン管理システム、アプリケーションサーバー、およびその他のツールとの統合を提供する、さまざまな言語とフレームワークのコーディング支援サポートを追加する、ショートカットヒント、ライブプレビュー、ファイルウォッチャーなどで生産性を向上、コーディング演習と検証で新しいプログラミング言語を...

Docker
Docker を使用すると、開発者は、本番環境と同じ環境でコードをテストするために、コンテナー内にアプリケーションをデプロイできます。PhpStorm は、Docker プラグインを使用して Docker サポートを提供します。プラグインはバンドルされており、デフォルトで有効になっています。Docker プラグインは PhpStorm にバンドルされており、デフォルトでアクティブ化されています。プラグインが無効になっている場合は、プラグインの管理の説明に従って、設定 / 環境設定 | プラグインページ...

Vagrant: 再現可能な開発環境の使用
Vagrant は、仮想マシンのライフサイクルを管理するために使用されるコマンドラインユーティリティです。PhpStorm は、Vagrant との完全な統合を提供し、Vagrant 仮想環境の構成、仮想マシンの動作の制御、およびプロジェクト内からの Vagrant コマンドの実行を可能にします。Vagrant を使用する場合、次の定義が満たされます。Vagrantfile:Vagrant 環境を定義し、仮想ボックスのすべての構成を格納し、仮想マシンの操作方法を Vagrant に指示するメイン構...

キーボードショートカットを設定する
PhpStorm 標準のキーボードショートカット PDF は、公式ショートカット一覧 PDF 日本語版から入手できます。ローカルに保存しておいて活用しましょう。PhpStorm には定義済みのキーマップがいくつか含まれており、頻繁に使用するショートカットをカスタマイズできます。キーマップ構成を表示するには、設定 / 環境設定ダイアログを開き、キーマップを選択します。PhpStorm は、環境に基づいて事前定義されたキーマップを自動的に提案します。使用している OS と一致することを確認するか、...

実行 / デバッグ構成を操作する
PhpStorm でコードを実行またはデバッグするには、実行 / デバッグ構成を使用できます。各実行 / デバッグ構成は、名前付きの実行 / デバッグ起動プロパティのセットを表します。PhpStorm を使用して実行、デバッグ、またはテストの操作を実行するときは、常にそのパラメーターを使用して、既存の構成のいずれかに基づいてプロセスを開始します。PhpStorm には、さまざまな実行、デバッグ、テストの問題に対して、いくつかの実行 / デバッグ構成タイプが付属しています。特定のタイプの独自の実行...