PhpStorm 2020.3 ヘルプ

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

  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 アドレス間の対応を設定するパスマッピングが必要です。PhpStorm はまず、使用可能なすべてのアプリケーションレベルの構成を処理することにより、パスマッピング自体を取得しようとします。PhpStorm が、選択された SSH 構成で指定されたものと同じホストの構成を検出した場合、これらの構成からのマッピングは自動的にマージされます。このホストの構成が見つからない場合、PhpStorm はパスマッピングが構成されていないことを通知するエラーメッセージを表示します。

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

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

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

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

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

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

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

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

始める前に:

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

  2. Docker および PHP Docker プラグインがインストールされ、有効になっていることを確認します。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。

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

Docker で PhpStorm で 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 デーモンの接続設定を構成するを参照してください。リストから構成を選択するか、新規... をクリックして、開いた Docker ページに新しい構成を作成します。

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

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

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

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

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

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

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

始める前に:

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

  2. Docker および PHP Docker プラグインがインストールされ、有効になっていることを確認します。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページでプラグインを有効にします。

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

Docker Compose の使用で PhpStorm で 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 デーモンの接続設定を構成するを参照してください。リストから構成を選択するか、新規... をクリックして、開いた Docker ページに新しい構成を作成します。

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

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

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

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

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

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

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

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

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

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

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

始める前に:

  1. Vagrant: 再現可能な開発環境の使用に従って、Vagrant(英語)Oracle の VirtualBox(英語) がコンピューター上でダウンロード、インストール、設定されていることを確認してください。

  2. プラグインの管理の説明に従って、設定 / 環境設定 | プラグインページのインストール済みタブで Vagrant バンドルプラグインが有効になっていることを確認します。

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

    • VBoxManage.exe または VBoxManage を使用してください。

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

Vagrant: 再現可能な開発環境の使用で PhpStorm で 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 の環境設定ファイルが置かれているフォルダーです。この設定に基づいて、PhpStorm は Vagrant ホストを検出し、それを Vagrant ホスト URL の読み取り専用フィールドにリンクとして表示します。

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

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

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

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

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

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

  7. CLI インタープリターダイアログで、phpinfo の表示 Show phpinfo button をクリックして、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 インタープリターを構成する

  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 の場合、PhpStorm はデフォルトで /usr/local/bin/php を提案します。

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

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

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

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

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

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

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

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

  3. 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 モードでのデバッグを参照)。

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

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

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

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

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

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

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

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

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

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

  3. プロジェクトパスマッピングの編集ダイアログには、デプロイ構成、Vagrantfile、または 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

関連ページ:

ローカル 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 には、さまざまな実行、デバッグ、テストの問題に対して、いくつかの実行 / デバッグ構成タイプが付属しています。特定のタイプの独自の実行...