PHPSpec

このダイアログは、 PHP および PHPSpec プラグインがインストールされて有効になっている場合にのみ使用できます。プラグインはデフォルトでアクティブ化されています。プラグインが無効になっている場合は、プラグインの説明に従って、プラグインページで有効化します。

このダイアログを使用して、 PHPSpec ツールセットを使用して PHP アプリケーションの単体テストを実行およびデバッグするために使用する構成を作成します。

始める前に

PHPSpec テストを実行するには:

PHPSpec の説明に従って、コンピューターに PHPSpec(英語) ツールセットをインストールして設定します。
PHP および PHPSpec プラグインが有効になっていることを確認してください。
プラグインはデフォルトでアクティブ化されています。プラグインが無効になっている場合は、プラグインの説明に従って、プラグインページでプラグインを有効化します。

テストランナーエリア

この領域では、起動する仕様を指定し、コマンドラインスイッチを PHPSpec に渡します。

項目	説明
テストスコープ	この領域では、指定された場所または構成ファイルの場所を指定します。 Directory: このオプションを選択すると、ディレクトリ内のすべての指定が起動されます。 Directory フィールドで、指定のある Spec.php ファイルを検索するディレクトリを指定します。ディレクトリへのパスを手動で入力するか、参照をクリックして、表示されるテストディレクトリを選択するダイアログで目的のディレクトリを選択します。ファイル: 特定の Spec.php ファイルのすべての仕様を起動するには、このオプションを選択します。ファイルフィールドで、仕様を検索する Spec.php ファイルを指定します。ファイルへのパスを手動で入力するか、参照をクリックして表示されるダイアログで目的のディレクトリを選択します。クラスフィールドに、希望のクラスを指定します。クラス名を手動で入力するか、参照をクリックして、ツリービューで目的のクラスを選択して開きます。仕様: 特定の仕様を起動するには、このオプションを選択します。ファイルフィールドで、仕様を検索する Spec.php ファイルを指定します。ファイル名を手動で入力するか、参照をクリックして、表示されるツリービューで目的のファイルを選択します。仕様フィールドに、希望する仕様を入力します。構成ファイルで定義: このオプションを選択すると、 PHPSpec は専用の .yml 設定ファイルからテストを実行します。デフォルトでは、 PHPSpec はテストフレームワークページのテストランナー領域に指定された設定ファイルを使用します。つまり、これはネイティブ構成ファイル（ phpspec.yml または phpspec.yml.dist ）、または PhpStorm の PHPSpec の初期構成時にデフォルトとして指定したその他の YML 構成ファイルのいずれかです。すべての PHPSpec 実行構成ファイルのデフォルトを使用するには、代替構成ファイルを使用チェックボックスをオフにします。カスタム設定ファイルから仕様を起動するには、代替構成ファイルを使用チェックボックスを選択し、隣のフィールドに目的の YML ファイルの場所を指定します。 PHPSpec ページを開き、使用する別のデフォルト設定ファイルを指定するには、ボタンをクリックします。

項目

説明

テストスコープ

この領域では、指定された場所または構成ファイルの場所を指定します。

Directory: このオプションを選択すると、ディレクトリ内のすべての指定が起動されます。
Directory フィールドで、指定のある *Spec.php ファイルを検索するディレクトリを指定します。ディレクトリへのパスを手動で入力するか、参照をクリックして、表示されるテストディレクトリを選択するダイアログで目的のディレクトリを選択します。
ファイル: 特定の *Spec.php ファイルのすべての仕様を起動するには、このオプションを選択します。
1. ファイルフィールドで、仕様を検索する *Spec.php ファイルを指定します。ファイルへのパスを手動で入力するか、参照をクリックして表示されるダイアログで目的のディレクトリを選択します。
2. クラスフィールドに、希望のクラスを指定します。クラス名を手動で入力するか、参照をクリックして、ツリービューで目的のクラスを選択して開きます。
仕様: 特定の仕様を起動するには、このオプションを選択します。
1. ファイルフィールドで、仕様を検索する *Spec.php ファイルを指定します。ファイル名を手動で入力するか、参照をクリックして、表示されるツリービューで目的のファイルを選択します。
2. 仕様フィールドに、希望する仕様を入力します。
構成ファイルで定義: このオプションを選択すると、 PHPSpec は専用の .yml 設定ファイルからテストを実行します。
デフォルトでは、 PHPSpec はテストフレームワークページのテストランナー領域に指定された設定ファイルを使用します。つまり、これはネイティブ構成ファイル（ phpspec.yml または phpspec.yml.dist ）、または PhpStorm の PHPSpec の初期構成時にデフォルトとして指定したその他の YML 構成ファイルのいずれかです。
- すべての PHPSpec 実行構成ファイルのデフォルトを使用するには、代替構成ファイルを使用チェックボックスをオフにします。
- カスタム設定ファイルから仕様を起動するには、代替構成ファイルを使用チェックボックスを選択し、隣のフィールドに目的の YML ファイルの場所を指定します。
- PHPSpec ページを開き、使用する別のデフォルト設定ファイルを指定するには、ボタンをクリックします。

コマンドラインエリア

この領域では、PHP インタープリターを選択し、PHP 実行可能ファイルに渡すオプションと引数を指定して、その動作をカスタマイズします。

項目	説明
インタープリター	リストには、現在設定されているすべてのローカルおよびリモート PHP インタープリターが含まれています。リストから構成済みの PHP インタープリターのいずれかを選択するか、をクリックして、ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成の説明に従って新しいインタープリターを定義します。
インタープリターオプション	このフィールドで、PHP 実行可能ファイルに渡されるオプション(英語)を指定します。これらは、PHP インタープリターのデフォルトの動作をオーバーライドするか、追加のアクティビティが確実に実行されるようにします。必要に応じて、をクリックしてコマンドラインオプションダイアログに希望のオプションを入力します。各オプションを新しい行に入力します。ダイアログを閉じると、それらはすべてコマンドラインオプションフィールドにスペースとして区切り記号として表示されます。
カスタム作業ディレクトリ	このフィールドでは、テストのあるフォルダーの外にあり、テストで相対パスを介して参照されるファイルの場所を指定します。テストの場所は常に対応するファイルとディレクトリへのフルパスで指定されるため、この設定はテストの実行をブロックしません。デフォルトでは、フィールドは空で、作業ディレクトリはプロジェクトのルートです。
環境変数	このフィールドには、組み込みサーバーに渡す環境変数を指定します。環境変数の名前と値のペアを手動で追加するには、をクリックするか、をクリックしてコンピューター上の `.env` ファイルを参照します。詳細は、 Apache の環境変数(英語)を参照してください。

Docker Compose エリア

この領域は、インタープリターフィールドで Docker Compose ベースのリモートインタープリターを選択した場合にのみ表示されます。ここで、実行構成にオプション付きの Docker Compose コマンド(英語)を追加できます。

項目

説明

コマンドとオプション

Docker Compose コマンドラインインターフェースの次のコマンドを使用できます。

コマンド	サポートされているオプション
up(英語): サービスのコンテナーをビルド、作成、開始、アタッチします。	`--abort-on-container-exit` `--build` `--exit-code-from SERVICE` `--scale SERVICE=NUM...` `--timeout TIMEOUT`
run(英語): サービスに対して 1 回限りのコマンドを実行します。	`--entrypoint CMD` `-l, --label KEY=VAL` `--name NAME` `-p, --publish=[]` `--rm` `--service-ports` `--use-aliases` `-u, --user=""` `-v, --volume=[]`
exec(英語): サービスで任意のコマンドを実行します。	`--index=index` `--privileged` `-u, --user USER`

コマンドプレビュー

このフィールドを使用して、完全なコマンド文字列をプレビューします。

例: コマンドとオプションフィールドの up --build exec --user jetbrains の組み合わせは、プレビューで次の出力を生成します。

共通設定

実行構成を編集するとき（ただし実行構成テンプレートは編集しないとき）、次のオプションを指定できます。

項目	説明
Name	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
複数のインスタンスを許可する	この実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PhpStorm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。
プロジェクトファイルとして保存	デフォルトの場所は .idea/runConfigurations です。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。デフォルトでは無効になっており、PhpStorm は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

Name

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PhpStorm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存

デフォルトの場所は .idea/runConfigurations です。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、PhpStorm は実行構成設定を .idea/workspace.xml に保存します。

Before launch

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

項目	ショートカット	説明
	`Alt+Insert`	このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。 Web ブラウザーの起動: ブラウザーを起動するには、このオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を指定します。また、ブラウザーを JavaScript デバッガーで起動するかどうかも指定します。外部ツールの実行: 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 PhpStorm でまだ定義されていない場合は、定義を追加します。詳細については、外部ツールと外部ツールを参照してください。別の構成を実行: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。ファイル監視の実行: PhpStorm に現在アクティブなすべての File Watchers を適用させるには、このオプションを選択します。リモート外部ツールの実行: リモート SSH 外部ツールを追加します。 Grunt タスクの実行: Grunt タスクを実行するには、このオプションを選択してください。表示される Grunt task ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。 gulp タスクの実行: Gulp タスクを実行するには、このオプションを選択してください。表示される Gulp task ダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。 npm スクリプトの実行: npm スクリプトを実行するには、このオプションを選択してください。開いた NPM スクリプトダイアログで、 npm 実行 / デバッグ構成設定を指定します。 TypeScript のコンパイル: 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。 CoffeeScript ソースマップの生成: CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。リモートホストにファイルをアップロードする: このオプションを選択すると、デフォルトのサーバーアクセス構成に従って、アプリケーションファイルが自動的にサーバーにアップロードされます。
	`Alt+Delete`	このアイコンをクリックして、選択したタスクをリストから削除します。
	`Enter`	選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
	`Alt+Up` `Alt+Down`	これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する		実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする		デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、 `Alt+4` または `Alt+5` を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。
ツールウィンドウにフォーカス		実行 / デバッグ構成を開始したときに、実行またはデバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

ログ

次のオプションは、この構成の実行のログ記録に関連しています。詳細は、 Karma を参照してください。

項目	説明
コンソールに表示するログファイルの指定	アプリケーションの実行中に表示するログファイルを指定します。をクリックして新しいログを追加します。ログファイルエイリアスの編集ダイアログで、次のように構成します。エイリアス: ログが表示されるタブの名前。ログファイルのロケーション: ログファイルまたは Ant パターン(英語)へのパスを指定します。ローリングログの複数のファイルがパターンに一致する場合、PhpStorm は最新のファイルを表示します。パターンでカバーできるすべてのファイルを表示する: パターンに一致するすべてのログを表示します。テーブル内のログについては、次のオプションを構成できます。アクティブ: 指定したログファイルを表示します。内容のスキップ: 以前の実行からの古いログメッセージを表示しません。
コンソール出力をファイルに保存する	コンソール出力を指定の場所に保存します。パスを手動で入力するか、参照ボタンをクリックして表示されるダイアログで目的の場所を指定します。
メッセージが標準出力に出力されたときにコンソールを表示する	アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。
メッセージが標準エラーに出力されたときにコンソールを表示する	アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。

2026 年 11 月 9 日