ターミナル

PhpStorm には、IDE から直接コマンドラインツールを操作するための組み込みターミナルエミュレーターが含まれています。専用のターミナルアプリケーションに切り替えることなく、Git リポジトリの管理、ファイル権限の設定、AI コーディングエージェントの操作、その他のコマンドラインタスクの実行に使用します。

ターミナルプラグインを有効化

この機能は、デフォルトで PhpStorm にバンドルされて有効になっているターミナル(英語)プラグインに依存しています。関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
ターミナルプラグインを見つけて、許可をクリックします。

ターミナルは libghostty を利用しています。これは Ghostty プロジェクトのターミナルエミュレーションライブラリです。

初期状態では、ターミナルエミュレーターはデフォルトのシステムシェルで実行されますが、Windows PowerShell、コマンドプロンプト、 sh、 bash、 zsh、 csh など、他の多くのシェルもサポートしています。シェルの変更の詳細については、「ターミナル設定」を参照してください。デフォルトのシェルを変更せずに単一のタブで別のシェルを実行するには、別のシェルでセッションを開始するを参照してください。

ターミナルツールウィンドウにアクセスする

表示 | ツールウィンドウ | ターミナルに移動するか、 Alt+F12 を押します。
デフォルトでは、ターミナルエミュレータは、現在のディレクトリを現在のprojectのルートディレクトリに設定して実行します。デフォルトの開始ディレクトリを変更する方法についての詳細は、ターミナル設定を参照してください。
任意のファイル（たとえば、 Project ツールウィンドウ（Alt+1 ）内、開いているエディタータブ内）を右クリックして開く | ターミナルを選択すると、そのファイルのディレクトリで新しいセッションを持つターミナルツールウィンドウが開きます。

ターミナルセッション

ローカルセッション

新しいローカルセッションを開始する

別のタブで新しいセッションを開始するには、ツールバーのをクリックするか、 Ctrl+Shift+T を押します。
タブを閉じるには、ターミナルツールバーのをクリックするか、 Ctrl+F4 を押します。
実行中のセッションを終了するには、をクリックしてタブを閉じ、プロセスの終了を確認します。
アクティブなタブを切り替えるには、 Alt+Right と Alt+Left を押します。または、 Alt+Down を押すと、すべてのターミナルタブのリストが表示されます。
ターミナル画面をクリアするには、 ⌘ K を押します。

ターミナルは、projectまたは PhpStorm を閉じるとタブとセッションを保存します。タブ名、現在の作業ディレクトリ、さらにはシェル履歴も保持されます。

定義済みセッション

PhpStorm は、定義済みセッション用の一般的なシェルを自動的に検出し、そのいずれかを新しいタブで実行できます。選択したシェルは現在のタブにのみ適用され、他のタブには影響しません。新しく作成されたタブは、ターミナル設定で指定されたデフォルトのシェルを引き続き使用します。

検出されたシェルでセッションを開始する

ターミナルツールバーで、新しい定義済みセッションをクリックします。
リストからシェルを選択します。 PhpStorm はシェルにちなんで命名された新しいタブを開き、その中でセッションを開始します。

リストには次のシェルが含まれます:

Windows の場合: Windows PowerShell、コマンドプロンプト、パワーシェル、 Git バッシュ、およびインストール済みの WSL ディストリビューション。
macOS と Linux の場合: bash、 zsh、 fish 、および pwsh は /bin 、 /usr/bin 、 /usr/local/bin 、および /opt/homebrew/bin にあります。

これらの場所の外にあるシェルや、その他の種類のシェルは、自動的には検出されません。使用するには、実行可能ファイルへのパスをシェルパスオプションで指定します (設定 | ツール | ターミナル内)。

検出された複数のシェルの名前が同じ場合、PhpStorm は名前にパスを追加します。例: zsh (/bin/zsh) と zsh (/opt/homebrew/bin/zsh)。

project が WSL または Dev Container 内にある場合、リストではシェルが環境別にグループ化され、その環境またはホストマシンでセッションを開始できます。

SSH セッション

SSH Remote 実行プラグインを有効化

この機能は SSH Remote 実行プラグインに依存しており、このプラグインはデフォルトで PhpStorm にバンドルされ、有効化されています。関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
SSH Remote 実行プラグインを見つけて、許可をクリックします。

Start a new SSH session

ターミナルツールバーで、をクリックし、新規 SSH セッションを選択します。
接続するホストのアドレスを入力し、認証データを提供します。
または、 SSH を構成している場合は、リストからいずれかを選択できます。

接続を終了するには、ターミナルタブでをクリックします。

ターミナルで作業する

ターミナルで検索

ターミナルセッションで特定の文字列を検索するには、 Ctrl+F を押します。これにより、セッション内のすべてのテキスト (プロンプト、コマンド、出力) が検索されます。

デフォルトでは、検索は大文字と小文字を区別しません。検索フィールドで「」（大/小文字の区別）をクリックすると、大文字と小文字が区別されます。

ターミナルタブの名前を変更する

タブを右クリックし、コンテキストメニューからセッション名の変更を選択します。

ターミナルで補完を使用する

PhpStorm は、コマンドの名前、オプション、引数（パス、Git ブランチ、フラグなど）に対して補完を提供します。

入力すると、ターミナルツールウィンドウに自動的に候補が表示されます。デフォルトでは、PhpStorm はパラメーターの候補を表示します。

サブコマンド、パラメーター、引数の補完を有効にするには、設定 | ツール | ターミナル | コマンド補完に移動し、入力しながら補完ポップアップを表示するオプションに常に実行を選択します。
補完ポップアップを手動で呼び出すには、 Ctrl+Space を押します。
設定 | ツール | ターミナル | コマンド補完の補完ポップアップを表示するオプションを使用してデフォルトのショートカットを変更できます。
提案を受け入れるには、リストで提案を選択し、 Enter を押します。
候補を挿入する現在のショートカットは、補完ポップアップ下部のヒントに表示されます。設定 | ツール | ターミナル | コマンド補完の提案を挿入オプションを使用して変更できます。

ターミナルからファイルやフォルダーへ移動する

ターミナルは、ファイルやフォルダーへの絶対パスと相対パスを認識してハイライトします。マウスカーソルを重ねると、ハイパーリンクとして表示されます。これにより、コンパイルメッセージ、ビルドエラー、AI コーディングエージェントの応答で参照されている場所にすばやく移動できます。

Ctrl キーを押しながらターミナルでファイル名をクリックすると、エディターでファイルが開きます。
Ctrl キーを押しながらターミナルでフォルダー名を含むリンクをクリックすると、 Project ツールウィンドウにそのフォルダーが表示されます。フォルダーが現在のプロジェクト外にある場合は、PhpStorm キーを押すとデフォルトのファイルシステムエクスプローラーが開きます。
または、ファイル名またはフォルダー名をクリックし、ツールチップに表示される開くリンクを使用してください。

ファイルやフォルダーをターミナルにドラッグ＆ドロップする。

Project ツールウィンドウ（Alt+1 ）やシステムのファイルマネージャから、ファイルやフォルダーをターミナルツールウィンドウにドラッグできる。ドロップする場所によって、結果が異なります。

ファイルまたはフォルダーをターミナル出力エリア（1）にドロップすると、現在のセッションのプロンプトにそのパスが貼り付けられます。
ファイルコンテキストを CLI コーディングエージェントに送信する場合や、パスを引数として取るコマンドを実行する場合に便利です。
ファイルまたはフォルダーをターミナルタブエリア（2）にドロップすると、作業ディレクトリがドロップしたフォルダー、またはドロップしたファイルの親フォルダーに設定された新しいタブが開きます。

ターミナルレイアウトをカスタマイズする

ワークフローに合わせてターミナルタブを配置します: 複数のセッションを横に並べて表示する、エディター領域でセッションを開く、またはターミナルツールウィンドウをメインウィンドウから切り離すことができます。

ターミナルタブを分割する

ターミナルツールウィンドウを複数のタブグループに分割し、複数のセッションを同時に操作できます。たとえば、CLI コーディングエージェントをあるグループで実行し、他のシェルコマンドを別のグループで実行します。分割アクションで開いた新しいタブは、元のタブの作業ディレクトリでセッションを開始します。

Split Right で 2 つのタブグループに分割された Terminal ツールウィンドウ

現在のタブの隣に新しいタブを開くには、タブを右クリックして右に分割または下に分割を選択します。
タブを別のグループに移動するには、タブを右クリックして分割して右に移動または分割して下に移動を選択します。これらのオプションは、グループに複数のタブが含まれている場合に使用できます。
または、タブをターミナルツールウィンドウのいずれかの端にドラッグします。 PhpStorm は、新しいグループが表示される領域をハイライトします。タブを既存のグループに移動するには、そのグループのタブヘッダーにドラッグします。
グループ間でフォーカスを移動するには、グループをクリックするか、ウィンドウ | アクティブなツールウィンドウ | 次のスプリッターに Go (⌥ ⇥) または前の分割に移動 (⌥ ⇧ ⇥) に移動します。
分割されたタブグループを結合するには、タブを右クリックして分割しないを選択します。以前にツールウィンドウを複数回分割している場合は、各分割に対してこのアクションを繰り返します。または、グループのすべてのタブを別のグループのタブヘッダーにドラッグします。グループの最後のタブを閉じるか移動すると、グループは自動的に削除されます。

エディターでターミナルタブを開く

ターミナルツールウィンドウからエディター領域にタブを移動し、通常のエディタータブとして使用できます。

ターミナルツールウィンドウのタブを右クリックし、エディタータブとして開く (Alt+Shift+Enter) を選択するか、タブをエディター領域にドラッグします。
ツールウィンドウ内の最後のタブを移動すると、ターミナルツールウィンドウは自動的に非表示になります。
タブを戻すには、エディターでタブを右クリックしてツールウィンドウに戻るを選択するか、ターミナルツールウィンドウにドラッグします。

これにより、セッションでエディター領域の高さいっぱいを使用できるため、長時間実行されるコマンドの出力を追跡する場合や CLI コーディングエージェントを使用する場合に役立ちます。タブの移動中もセッションは実行され続けるため、コマンド履歴と出力は保持されます。

ターミナルツールウィンドウを IDE 上にフローティング表示するか、別のウィンドウに移動するには、表示モードを変更します。

ターミナルエンジン

現在、PhpStorm では次のターミナルエンジンが利用可能です。

改訂版 (デフォルト)。バージョン 2025.2 以降、PhpStorm のデフォルトのターミナルエンジンです。クラシックエミュレータの安定性と、パフォーマンス、互換性、最新の機能強化を組み合わせるように設計されています。
クラシック。これは、 JediTerm(英語) ライブラリに基づいて構築された、前世代の標準的なターミナルエミュレーターであり、ユーザー入力 (コマンドとキーストローク) は基盤となるシェルに直接送信されます。

実験的 2024 (非推奨) ターミナルエンジン（PhpStorm 2024.* では New Terminal とも呼ばれていました）は、互換性の問題により非推奨となりました。このターミナルエンジンを選択するオプションは、PhpStorm 2024.* で有効にしていたユーザーのみ利用可能です。このエンジンに関するドキュメントは、以前のバージョンの PhpStorm ヘルプに記載されています。