PhpStorm 2026.1 Help

ローカル PHP インタープリターを構成する

ローカル PHP インタープリターは 、リモートホスト、Docker コンテナー、または Vagrant 仮想環境にインストールされる リモート PHP インタープリターとは異なり、コンピューターにインストールされる PHP エンジンです。

ローカル PHP インタープリターを構成する

  1. Ctrl+Alt+S を押して設定を開き、 PHP を選択します。

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

    CLI インタープリターを開くダイアログ
  3. 開いた CLI インタープリター ダイアログの左側ペインで 追加ボタン をクリックし、ポップアップメニューから ローカル を選択します。

    PhpStorm ですでにローカルインタープリターが構成されている場合は、メニューリストに表示され、メニュー項目が その他のローカル に変わります。

  4. ダイアログの右側のペインで、新しい PHP インタープリターの名前と一般設定を指定します。

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

    フィールド

    説明

    命名

    他のインタープリターと区別するために、インタープリター名を入力します (例: php_installation_<バージョン>)。

    PHP 実行可能ファイル

    PHP エンジンのインストールディレクトリへのパスを指定します。 手動で入力するか、「閲覧ボタン 」をクリックして表示されるダイアログで該当するフォルダーを選択してください。

    構成ファイル

    カスタム php.ini 設定ファイルへのパスを指定します。 IDE によって自動検出され、下の編集不可の 構成ファイル フィールドに表示されているものとは異なる php.ini ファイルを指定したい場合は、このフィールドを使用してください。 手動で入力するか、「閲覧ボタン 」をクリックして表示されるダイアログで該当するファイルを選択してください。

    このプロジェクトでのみ表示

    インタープリターの使用を現在のプロジェクトのみに制限するには、チェックボックスを選択します。

    PhpStorm は、指定フォルダーで検出した PHP エンジンのバージョン、 php.ini ファイル内でこの PHP エンジンに関連付けられたデバッガー、および指定された php.ini ファイルを PhpStorm のエディターで開くためのアクションリンクを表示します。

    PHP 実行可能ファイル 」フィールドの横にある「the Show phpinfo button 」をクリックすると、別の情報ウィンドウが開き、インストールの詳細、ロードされた拡張機能と構成されたオプションのリストが表示されます。

  5. CLI インタープリター ダイアログの 追加 領域で、PHP インストールの構成設定をカスタマイズします。

    フィールド

    説明

    デバッガー拡張機能​​[半角スペース]​​

    オンデマンドモードでデバッグ用の Xdebug 実行ファイルへのパスを指定します。 この方法により、 php.ini ファイルで Xdebug が無効化されている場合でも、PhpStorm で Xdebug をアクティブ化できます。

    構成オプション

    -d コマンドラインオプション(英語)に渡される構成ディレクティブの文字列を作成し、 php.ini ファイルに新しいエントリを追加します。 このフィールドで指定されたディレクティブは、PhpStorm が生成するデフォルトのディレクティブをオーバーライドします。例えば:

    -dxdebug.mode=debug, -dxdebug.client_host=127.0.0.1, -dxdebug.client_port=9003, -dxdebug.start_upon_error=default

    例: -dxdebug.start_upon_error=yes ディレクティブを指定すると、デフォルトの -dxdebug.start_upon_error=default ディレクティブがオーバーライドされ、 Xdebugジャストインタイム (JIT) モードに切り替わります。 詳細については、 Just-In-Time モードでのデバッグ を参照してください。

    -dxdebug.remote_enable=1, -dxdebug.remote_host=127.0.0.1, -dxdebug.remote_port=9000, -dxdebug.remote_mode=req

    例: -dxdebug.remote_mode=jit ディレクティブを指定すると、デフォルトの -dxdebug.remote_mode=req ディレクティブがオーバーライドされ、 Xdebugジャストインタイム (JIT) モードに切り替わります。 詳細については、 Just-In-Time モードでのデバッグ を参照してください。

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

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

      必要に応じてエントリをいくつでも追加できますが、それらはコマンドラインに変換され、その長さは 256 文字に制限されることに注意してください。

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

    • エントリの順序を変更するには、 上ボタン または 下ボタン をクリックします。

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

  6. 適用 および OK をクリックして変更を保存します。

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

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

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

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

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

Switching the PHP interpreter
2026 年 5 月 22 日