実行 / デバッグ構成
PhpStorm は、実行 / デバッグ構成を使ってコードを実行、デバッグ、テストします。 各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。
実行 / デバッグ 構成には 2 種類があります：
一時的 — コンテキストメニューから を選択するたびに作成されます。 コンテキストメニューを呼び出すには、オブジェクトまたは領域を右クリックします。
永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。 永続的な構成は、削除するまでプロジェクトの一部として残ります。
コードを実行、デバッグ、テストするたびに、PhpStorm は既存の永続的な実行 / デバッグ構成を使用するか、新しい一時的な構成を作成します。
永続的な構成のアイコンは不透明ですが、一時的な構成のアイコンは半透明です。 構成アイコン上の赤い十字は、構成設定にエラーがあることを示します。
一時構成の最大数は 5 です。 新しい構成が追加されると、古い構成は自動的に削除されます。 必要に応じて、 でこの制限を増やすことができます。
永続的な実行 / デバッグ構成を作成する
PhpStorm は、永続的な実行/デバッグ構成を作成するための次の方法を提供します：
テストやタスクランナーの実行可能ファイルの宣言（クラス、メソッド、データプロバイダーなど）に対しては、 エディターから永続的な実行/デバッグ構成を作成できます。
テンプレートから作成または既存の構成をコピーします。
エディターから永続的な実行/デバッグ構成を作成する
エディターで、実行可能宣言 (テストメソッドやクラスなど) にキャレットを置き、 Alt+Enter を押します。
開いたメニューから 実行構成の変更 を選択します。
PhpStorm は、対応する型の永続的な実行 / デバッグ構成を作成し、構成パラメーターを設定できるダイアログを開きます。
一時的な構成を永続的なものとして保存する
実行 / デバッグ 構成スイッチャーで一時構成を選択し、
/
をクリックし、 構成の保存 を選択します。
または、実行 / デバッグ構成ダイアログで一時構成を選択し、ツールバーの
をクリックします。
PhpStorm は、さまざまな言語、ツール、フレームワーク向けの実行 / デバッグ構成 テンプレートを提供します。 使用可能なテンプレートのリストは、インストールされている プラグインと有効になっているプラグインによって異なります。
テンプレートから実行 / デバッグ構成を作成する
に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成 ダイアログで、ツールバーの
をクリックするか、 Alt+Insert を押します。 リストには、実行 / デバッグ構成テンプレートが表示されます。目的のテンプレートを選択します。 どのテンプレートを選択すればよいかわからない場合は、特定のテンプレートの詳細については 実行 / デバッグ構成ダイアログ を参照してください。
命名 フィールドに実行 / デバッグ構成名を指定します。 この名前は、リストやメニューで実行 / デバッグ構成を識別するために使用されます。
構成の複数のインスタンスを同時に実行できるようにする場合は、 複数のインスタンスを許可する を選択します。 このオプションが無効になっている場合、構成を再実行しようとすると、アクティブなセッションが終了します。
実行 / デバッグ構成パラメーターを構成します。 必須パラメーターとオプションのパラメーターのリストは、選択した実行 / デバッグ構成型によって異なる場合があります。
一部のオプションのパラメーターは非表示になっています。 これらを表示して有効にするには、 オプションを変更 リンクをクリックします。
選択したテンプレートの詳細については、 実行 / デバッグ構成リファレンスのそれぞれのセクションを参照してください。
起動前 セクションで、アプリケーションを起動する前に特定のアクションを実行するかどうかを定義できます。たとえば、実行 / デバッグ構成を開始する前にツールやスクリプトを実行できます。
特定の 起動前 アクティビティの詳細については、 起動前 を参照してください
構成をすぐに実行することも、構成を保存して後で実行することもできます。
実行構成を後で使用するために保存するには、 OK をクリックします。
構成をすぐに実行するには、「実行 」をクリックします。
起動前
この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します：
|
| Alt+Delete | このアイコンをクリックして、選択したタスクをリストから削除します。 |
| Enter | 選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。 |
| Alt+Up Alt+Down | これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。 |
このページを表示する | 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。 | |
ツールウィンドウをアクティブにする | デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。 それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、構成が実行されている場合は、 Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。 | |
ツールウィンドウにフォーカス | 実行 / デバッグ構成を開始したときに、 実行または デバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。 |
実行 / デバッグ構成を共有する
実行 / デバッグ 構成を共有することで、チームメイトが同じ構成を使ってアプリケーションを実行したり、実行中のプロセスにリモートでアタッチできるよう有効化したりできます。
PhpStorm は、実行 / デバッグ 構成をプロジェクトファイルとして保存し、VCS を通じて共有するメカニズムを提供します。 同じメカニズムは、構成をファイルとして他のユーザーに送信したり、実行 / デバッグ構成のローカルバックアップを作成したり、ファイルからインポートしたりする場合にも使用できます。
既存の .ipr ベースのプロジェクトは、個別の 実行 / デバッグ 構成をサポートしていません。 レガシープロジェクトでは、 .ipr ファイルを VCS に追加することによってのみ、一度にすべての構成を共有できます。
に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。
共有したい 実行 / デバッグ 構成を選択し、 プロジェクトファイルとして保存 オプションを有効化し、構成ファイルの保存場所を指定します。
PhpStorm 2019.3 以前との互換性が必要でない限り、任意の場所を設定できます。 これらのバージョンとの互換性を保つには、推奨される場所にファイルを保存してください。
(オプション) .idea ディレクトリが VCS 無視ファイルに追加されると、 .idea/runConfigurations サブフォルダーも無視されます。 プロジェクトで Git を使用する場合は、次のように .gitignore を変更することで、 .idea/runConfigurations を共有し、 .idea を無視したままにすることができます。
/.idea/* !/.idea/runConfigurations
実行 / デバッグ構成テンプレート
すべての実行 / デバッグ構成はテンプレートに基づいており、テンプレートは起動ロジックを実装し、パラメーターのリストとそのデフォルト値を定義します。 使用可能なテンプレートのリストはインストール時に事前定義されており、 プラグインを介してのみ拡張できます。 ただし、各テンプレートのデフォルトのパラメーター値を編集して、新しい実行 / デバッグ構成のセットアップを容易にすることができます。
テンプレートのデフォルト値を構成する
に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ 構成ダイアログの左側ペインで 構成テンプレートの編集… をクリックします。
開いた 実行 / デバッグ構成テンプレート ダイアログで、構成タイプを選択します。
必要なデフォルトパラメーターを指定し、 OK をクリックしてテンプレートを保存します。
実行 / デバッグ構成フォルダー
同じタイプの 実行 / デバッグ 構成が多い場合は、フォルダーにグループ化してアクセスしやすくできます。
実行 / デバッグ構成用のフォルダーを作成する
に進みます。 または、 Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成 ダイアログで、構成タイプを選択し、ツールバーの
をクリックします。 選択したタイプの新しい空のフォルダーが作成されます。右側のテキストフィールドにフォルダー名を指定するか、デフォルトの名前を受け入れます。
目的の 実行 / デバッグ 構成を選択し、ターゲットフォルダーに移動します。
変更を適用します。 フォルダーが空の場合、保存されません。
フォルダーが不要になった場合は、 Delete を削除できます。 このフォルダー内の 実行 / デバッグ 構成は、対応する 実行 / デバッグ 構成タイプのルートへ移動されます。
サービスツールウィンドウで実行 / デバッグ構成
サービス ツールウィンドウで複数の実行 / デバッグ構成を管理できます。 例: 複数のアプリケーションを開始、一時停止、停止し、それらのステータスを追跡し、アプリケーション固有の詳細を調べることができます。
サービスウィンドウに実行 / デバッグ構成を追加する
メインメニューから を選択するか、 Alt+8 を押します。
サービス ツールウィンドウで、
サービスの追加 をクリックし、次に 実行構成 を選択します。
リストから実行 / デバッグ構成タイプを選択すると、このタイプのすべての構成がウィンドウに追加されます。
選択したタイプの構成をすでに作成している場合、PhpStorm はそれらを専用ノードに表示します。 選択したタイプの構成がまだない場合は、IDE は 新規構成の追加 ダイアログを開き、そこで 新しい実行 / デバッグ構成を作成するを行うことができます。