PhpStorm 2024.3 ヘルプ

実行 / デバッグ構成

PhpStorm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。

実行 / デバッグ構成には 2 つのタイプがあります。

  • 一時的 — コンテキストメニューから実行 <項目名> を選択するたびに作成されます。コンテキストメニューを呼び出すには、オブジェクトまたは領域を右クリックします。

  • 永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するまでプロジェクトの一部として残ります。

コードを実行、デバッグ、テストするたびに、PhpStorm は既存の永続的な実行 / デバッグ構成を使用するか、新しい一時的な構成を作成します。

永続的な構成のアイコンは不透明ですが、一時的な構成のアイコンは半透明です。構成アイコン上の赤い十字は、構成設定にエラーがあることを示します。

一時構成の最大数は 5 です。新しい構成が追加されると、古い構成は自動的に削除されます。必要に応じて、設定 | 詳細設定 | 実行 / デバッグ | 一時的な構成の制限でこの制限を増やすことができます。

Permanent and temporary configurations have different icons

永続的な実行 / デバッグ構成を作成する

PhpStorm は、永続的な実行 / デバッグ構成を作成する次の方法を提供します。

エディターから永続的な実行 / デバッグ構成を作成する

  1. エディターで、実行可能宣言 (テストメソッドやクラスなど) にキャレットを置き、Alt+Enter を押します。

  2. 開いたメニューから実行構成の変更を選択します。

    Create run configuration for a class

    PhpStorm は、対応する型の永続的な実行 / デバッグ構成を作成し、構成パラメーターを設定できるダイアログを開きます。

一時的な構成を永続的なものとして保存する

  • 実行 / デバッグ構成スイッチャーで一時構成を選択し、 / をクリックして、構成の保存を選択します。

    Save a temporary run configuration
  • または、実行 / デバッグ構成ダイアログで一時構成を選択し、ツールバーの Save をクリックします。

PhpStorm は、さまざまな言語、ツール、フレームワーク用の実行 / デバッグ構成テンプレートを提供します。使用可能なテンプレートのリストは、インストールされているプラグインと有効になっているプラグインによって異なります。

テンプレートから実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログで、ツールバーの をクリックするか、Alt+Insert を押します。リストには、実行 / デバッグ構成テンプレートが表示されます。

    目的のテンプレートを選択します。選択するテンプレートがわからない場合は、特定のテンプレートの詳細について実行 / デバッグ構成ダイアログを参照してください。

    Selecting a new run/debug configuration template
  3. 名前フィールドに実行 / デバッグ構成名を指定します。この名前は、リストやメニューで実行 / デバッグ構成を識別するために使用されます。

  4. 構成の複数のインスタンスを同時に実行できるようにする場合は、複数のインスタンスを許可するを選択します。このオプションが無効になっている場合、構成を再実行しようとすると、アクティブなセッションが終了します。

  5. 実行 / デバッグ構成パラメーターを構成します。必須パラメーターとオプションのパラメーターのリストは、選択した実行 / デバッグ構成型によって異なる場合があります。

    一部のオプションのパラメーターは非表示になっています。これらを表示して有効にするには、オプションを変更リンクをクリックします。

    選択したテンプレートの詳細については、実行 / デバッグ構成リファレンスのそれぞれのセクションを参照してください。

  6. 起動前セクションで、アプリケーションを起動する前に特定のアクションを実行するかどうかを定義します。たとえば、実行 / デバッグ構成を起動する前にいくつかのツールまたはスクリプトを実行します。

    特定の起動前アクティビティの詳細については、起動前を参照してください。

  7. 構成をすぐに実行することも、構成を保存して後で実行することもできます。

    • 実行構成を後で使用するために保存するには、OK をクリックします。

    • 構成をすぐに実行するには、「実行」をクリックします。

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。タスクは、リストに表示されている順序で実行されます。

項目

ショートカット

説明

the Add button

Alt+Insert

このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。

  • 外部ツールの実行 : 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。PhpStorm でまだ定義されていない場合は、定義を追加します。詳細については、「外部ツールおよび外部ツール」を参照してください。

  • 別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。

  • Web ブラウザーの起動 : ブラウザーを起動するには、このオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を指定します。また、ブラウザーを JavaScript デバッガーで起動するかどうかも指定します。

  • ファイル監視の実行 : PhpStorm に現在アクティブなすべての File Watchers を適用させるには、このオプションを選択します。

  • Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。

    表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

    Node.js インタープリターの場所、渡すパラメーター、grunt-cli パッケージへのパスを指定します。

  • gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。

    表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。

    Node.js インタープリターの場所、それに渡すパラメーター、gulp パッケージへのパスを指定します。

  • npm スクリプトの実行 : npm スクリプトを実行するには、このオプションを選択してください。

    開いた NPM スクリプトダイアログで、npm 実行 / デバッグ構成設定を指定します。

  • TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

    • エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。

    • エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。

  • Phing ターゲットの実行 : 実行またはデバッグの前に、指定された Phing ターゲットを実行するためにこのタスクを追加してください。Phing ターゲットを指定するには、参照 the Browse button をクリックして表示されるダイアログで目的のターゲットを選択します。

  • CoffeeScript ソースマップの生成 : CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。

  • リモートホストにファイルをアップロードする : このオプションを選択すると、デフォルトのサーバーアクセス構成に従って、アプリケーションファイルが自動的にサーバーにアップロードされます。

  • リモート外部ツールの実行 : リモート SSH 外部ツールを追加します

the Remove button

Alt+Delete

このアイコンをクリックして、選択したタスクをリストから削除します。

Edit

Enter

選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。

Method up

Method down

Alt+Up

Alt+Down

これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。

このページを表示する

実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。

ツールウィンドウをアクティブにする

デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。

それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

実行 / デバッグ構成を共有する

実行 / デバッグ構成を共有して、チームメイトが同じ構成を使用してアプリケーションを実行できるようにしたり、実行中のプロセスにリモートでアタッチできるようにしたりすることができます。

PhpStorm は、実行 / デバッグ構成をプロジェクトファイルとして保存し、VCS を通じて共有するメカニズムを提供します。同じメカニズムは、構成をファイルとして他のユーザーに送信したり、実行 / デバッグ構成のローカルバックアップを作成したり、ファイルからインポートしたりする場合にも使用できます。

従来の .ipr ベースのプロジェクトは、個々の実行 / デバッグ構成をサポートしていません。レガシープロジェクトでは、.ipr ファイルを VCS に追加することによってのみ、一度にすべての構成を共有できます。

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 共有する実行 / デバッグ構成を選択し、プロジェクトファイルとして保存オプションを有効にして、構成ファイルを保存する場所を指定します。

    PhpStorm 2019.3 以前との互換性が必要でない限り、任意の場所を設定できます。これらのバージョンとの互換性を保つには、推奨される場所にファイルを保存してください。

    Store as project file box
  3. (オプション) .idea ディレクトリが VCS 無視ファイルに追加されると、.idea/runConfigurations サブフォルダーも無視されます。プロジェクトで Git を使用する場合は、次のように .gitignore を変更することで、.idea/runConfigurations を共有し、.idea を無視したままにすることができます。

    /.idea/* !/.idea/runConfigurations

実行 / デバッグ構成テンプレート

すべての実行 / デバッグ構成はテンプレートに基づいており、テンプレートは起動ロジックを実装し、パラメーターのリストとそのデフォルト値を定義します。使用可能なテンプレートのリストはインストール時に事前定義されており、プラグインを介してのみ拡張できます。ただし、各テンプレートのデフォルトのパラメーター値を編集して、新しい実行 / デバッグ構成のセットアップを容易にすることができます。

テンプレートのデフォルト値を構成する

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログの左側のペインで、構成テンプレートの編集をクリックします。

  3. 開いた実行 / デバッグ構成テンプレートダイアログで、構成タイプを選択します。

    Run/Debug templates
  4. 必要なデフォルトパラメーターを指定し、OK をクリックしてテンプレートを保存します。

実行 / デバッグ構成フォルダー

同じタイプの実行 / デバッグ構成が多数ある場合は、アクセスしやすいようにフォルダーにグループ化できます。

folders for run configurations

実行 / デバッグ構成用のフォルダーを作成する

  1. 実行 | 実行構成の編集に進みます。または、Alt+Shift+F10 を押してから 0 を押します。

  2. 実行 / デバッグ構成ダイアログで、構成タイプを選択し、ツールバーの the New Folder icon をクリックします。選択したタイプの新しい空のフォルダーが作成されます。

  3. 右側のテキストフィールドにフォルダー名を指定するか、デフォルトの名前を受け入れます。

  4. 目的の実行 / デバッグ構成を選択し、ターゲットフォルダーに移動します。

  5. 変更を適用します。フォルダーが空の場合、保存されません。

フォルダーが不要になった場合は、Delete を削除できます。このフォルダーにグループ化された実行 / デバッグ構成は、対応する実行 / デバッグ構成タイプのルートに移動されます。

サービスツールウィンドウで実行 / デバッグ構成

サービスツールウィンドウで複数の実行 / デバッグ構成を管理できます。例: 複数のアプリケーションを開始、一時停止、停止し、それらのステータスを追跡し、アプリケーション固有の詳細を調べることができます。

サービスウィンドウに実行 / デバッグ構成を追加する

  1. メインメニューから表示 | ツールウィンドウ | サービスを選択するか、Alt+8 を押します。

  2. サービスツールウィンドウで、サービスの追加をクリックし、実行構成タイプを選択します。

    Services tool window: Add run configuration
  3. リストから実行 / デバッグ構成タイプを選択して、このタイプのすべての構成をウィンドウに追加します。

    ツールウィンドウには、1 つ以上の構成を作成した構成タイプのみが表示されることに注意してください。

関連ページ:

プラグインのインストール

プラグインは PhpStorm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケッ...

実行 / デバッグ構成ダイアログ

このダイアログを使用して、実行 / デバッグ構成を作成、編集、調整、削除したり、新しく作成されたすべての実行 / デバッグ構成に適用されるデフォルトのテンプレートを構成したりします。既存の実行 / デバッグ構成は、構成タイプごとにグループ化されています。新しい構成を作成するためのテンプレートは編集可能であり、ダイアログの左側のペインにある構成テンプレートの編集リンクから利用できます。共通設定:実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。名...

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成して、PhpStorm から実行します。例: ワークフローでは、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサーまたはポストプロセッサー、データベースユーティリティなどの実行が必要になる場合があります。外部ツールとして構成することにより、PhpStorm は専用のアクションを提供します。これは、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の実行構成を起動すると...

外部ツール

このページでは、ローカル外部ツールに対して構成できる設定について説明します。外部ツールの追加と使用の詳細については、「外部ツール」を参照してください。ツールバーボタンを使用して、使用可能な外部ツールのリストを管理します。保持したいがメニューで使用できないツールとグループのチェックボックスをオフにします。追加新しい外部ツールを追加します。除去選択したツールまたはグループを削除します。編集選択したツールを編集します。上へ選択したツールをリスト内で上に移動します。

複数のターゲットを実行 / デバッグする

PhpStorm は、複数の異なるプロセスやタスクを起動する必要があるクライアントサーバーアプリや複雑なテストなど、複数のものを一度に実行 / デバッグする複数の方法を提供します。いずれの場合も、最初の手順は、起動する必要があるタスクまたはプロセスごとに実行構成を作成することです。必要な構成がすべて整ったら、次のオプションがあります。複合実行構成を使用する複数の構成を並行して起動する、起動前タスクを使用する複数の構成を順番に起動する、複数の構成を一度に起動すると、それぞれが実行またはデバッグツー...

File Watchers

File Watcher は、ファイルの変更を追跡し、サードパーティのスタンドアロンアプリケーションを実行する PhpStorm システムです。PhpStorm は、多数の標準的な一般的なサードパーティツール (コンパイラー、コンプレッサー、整形ツールなど) 用に定義済みの File Watcher テンプレートを提供します。カスタム File Watcher を設定して、他のサードパーティツールを実行することもできます。File Watchers には 2 つの専用コードインスペクションがありま...