PHPUnit

テストスコープ

この領域には、テストの場所または設定ファイルがリストされている場所を指定します。

• ディレクトリ : ディレクトリ内のすべてのユニットテストを起動するには、このオプションを選択します。

  ディレクトリフィールドで、単体テストを検索するディレクトリを指定します。ディレクトリへのパスを手動で入力するか、 をクリックして表示されるテストディレクトリを選択するダイアログで目的のディレクトリを選択します。

• クラス : テストクラス内のすべてのユニットテストを起動するには、このオプションを選択します。

  クラスフィールドに、目的のクラスの名前を入力します。クラスをすばやく見つけるには、コード補完 Ctrl+Space を使用します。選択したクラスの場所は、コントロールファイルの読み取り専用フィールドに表示されます。

• メソッド : 特定のテスト方法を起動するには、このオプションを選択します。

  クラスフィールドに、目的のクラスの名前を入力します。クラスをすばやく見つけるには、コード補完 Ctrl+Space を使用します。選択したクラスの場所は、コントロールファイルの読み取り専用フィールドに表示されます。

  メソッドフィールドで、目的の方法を指定します。クラスをすばやく見つけるには、コード補完 Ctrl+Space を使用します。

• 構成ファイルで定義 : テストランナーに専用の XML 設定ファイルからテストを実行させるには、このオプションを選択します。

• コンポジット : テストランナーに任意のテスト選択からテストを実行させるには、このオプションを選択します。

  コンポジットテストパターン領域で、、、 を使用して、構成に含まれるテストパターン（つまり、テストクラスまたはテストメソッド）のリストを管理します。

  テストパターンを追加するには、 をクリックします。既存のパターンを編集するには、 をクリックします。開いた PHPUnit テストパターンを追加ダイアログで、名前で検索タブまたはプロジェクトタブを使用して目的のテストクラスまたはテストメソッドシンボルを見つけます。選択したテスト方法でデータプロバイダを使用している場合は、データセットフィールドにデータセットの名前を入力します。複数のデータセットの場合は、それらのそれぞれに対して別々のパターンエントリを作成する必要があります。

  デフォルトでは、PhpStorm はプロジェクト構造に基づいてテストパターンの位置を自動的に検出しようとします。テストパターンを含むディレクトリを明示的に指定するには、代替パターンのベースパスを使用するチェックボックスを選択してから をクリックし、表示されるダイアログで目的のディレクトリを探します。

代替構成ファイルを使用

このフィールドで、PHPUnit 設定ファイル(英語)の場所を選択します。

• 設定ダイアログ (Ctrl+Alt+S) のテストフレームワークページで指定されたデフォルトの構成ファイルを使用するには、代替構成ファイルを使用チェックボックスをオフにします。テストフレームワークページでデフォルトの構成ファイルが指定されていない場合、実行 / デバッグ構成は無効です。テストフレームワークページをすぐに開くには、 をクリックします。

• カスタム設定ファイルからテストを実行するには、代替構成ファイルを使用チェックボックスを選択し、 をクリックして、使用するファイルの場所を指定します。

代替ブートストラップファイルを使用する

このフィールドで、テストを開始する前に実行される、ブートストラップ PHP スクリプトの場所を選択します。

• 設定ダイアログ (Ctrl+Alt+S) のテストフレームワークページで指定されたデフォルトのブートストラップファイルを使用するには、代替ブートストラップファイルを使用するチェックボックスをオフにします。

• カスタムブートストラップファイルを実行するには、代替ブートストラップファイルを使用するチェックボックスを選択し、 をクリックして、使用するファイルの場所を指定します。

テストランナーオプション

このフィールドで、テストランナースイッチ(英語)を指定します。

必要に応じて をクリックし、コマンドラインオプションダイアログに目的のスイッチを入力します。各スイッチを新しい行に入力します。ダイアログを閉じると、指定したスイッチがテストランナーオプションフィールドに区切り文字としてスペースとともに表示されます。

優先カバレッジエンジン

このリストから、構成済みのコードカバレッジランナーの 1 つを選択します。

• Xdebug(英語) は、デバッグ機能とコードカバレッジ機能の両方を提供するデバッグ拡張機能です。

  Xdebug を有効にするには、アクティブな php.ini ファイルの [xdebug] セクションで少なくとも次の設定が指定されていることを確認してください。

  [xdebug] zend_extension="<path to xdebug extension>" xdebug.mode=coverage

  [xdebug] zend_extension="<path to xdebug extension>" xdebug.coverage_enable=1

  詳細は、Xdebug を構成するを参照してください。

• PCOV(英語) は、コードカバレッジ機能のみを提供する軽量拡張です。

  PCOV を有効にするには、PCOV のドキュメント(英語)の説明に従って拡張機能をダウンロードしてインストールします。次に、アクティブな php.ini ファイルで少なくとも以下の設定が指定されていることを確認します。

  extension="<path to pcov extension>"

• phpdbg(英語)、デバッグおよびコードカバレッジモジュール。PHP5.6(英語) 以降にバンドルされており、追加の構成は必要ありません。

インタープリター

リストには、現在設定されているすべてのローカルおよびリモート PHP インタープリターが含まれています。リストから構成済みの PHP インタープリターのいずれかを選択するか、 をクリックして、ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成の説明に従って新しいインタープリターを定義します。

インタープリターオプション

このフィールドで、PHP 実行可能ファイルに渡されるオプション(英語)を指定します。これらは、PHP インタープリターのデフォルトの動作をオーバーライドするか、追加のアクティビティが確実に実行されるようにします。

必要に応じて、 をクリックしてコマンドラインオプションダイアログに希望のオプションを入力します。各オプションを新しい行に入力してください。ダイアログを閉じると、それらはすべてコマンドラインオプションフィールドにスペースとして区切り記号として表示されます。

カスタム作業ディレクトリ

このフィールドでは、テストのあるフォルダーの外にあり、テストで相対パスを介して参照されるファイルの場所を指定します。

テストの場所は常に対応するファイルとディレクトリへのフルパスで指定されるため、この設定はテストの実行をブロックしません。

デフォルトでは、フィールドは空で、作業ディレクトリはプロジェクトのルートです。

環境変数

このフィールドには、組み込みサーバーに渡す環境変数を指定します。環境変数の名前と値のペアを手動で追加するには、 をクリックするか、 をクリックしてコンピューター上の .env ファイルを参照します。

詳細は、Apache の環境変数(英語)を参照してください。

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 ターゲットを指定するには、参照 をクリックして表示されるダイアログで目的のターゲットを選択します。

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

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

Alt+Delete

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

Enter

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

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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