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 は、デバッグおよびコードカバレッジ用のモジュールで、PHP 5.6 以降にバンドルされており、追加の構成は不要です。

インタープリター

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

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

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

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

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

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

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

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

環境変数

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

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

Alt+Insert

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

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

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

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

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

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

• 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 のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

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

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

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

Alt+Delete

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

Enter

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

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

ツールウィンドウにフォーカス

実行 / デバッグ構成を開始したときに、 実行または デバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

コンソールに表示するログを指定

アプリケーションの実行中に表示するログファイルを指定します。

をクリックして新しいログを追加します。 ログファイルエイリアスの編集 ダイアログで、次のように構成します。

• エイリアス: ログが表示されるタブの名前。

• ログファイルのロケーション: ログファイルまたは Ant パターン(英語)へのパスを指定します。 ローリングログの複数のファイルがパターンに一致する場合、PhpStorm は最新のファイルを表示します。

• パターンでカバーできるすべてのファイルを表示する: パターンに一致するすべてのログを表示します。

テーブル内のログについて、以下のオプションを構成できます：

• アクティブ: 指定したログファイルを表示します。

• 内容をスキップ: 以前の実行からの古いログメッセージを表示しません。

コンソール出力をファイルに保存する

コンソール出力を指定の場所に保存します。 パスを手動で入力するか、参照ボタンをクリックして 表示されるダイアログで目的の場所を指定します。

メッセージが標準出力に出力されたときにコンソールを表示する

アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。

メッセージが標準エラーに出力されたときにコンソールを表示する

アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。