Pest

テストスコープ

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

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

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

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

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

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

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

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

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

代替構成ファイルを使用

必要に応じて、チェックボックスを選択し、「 」をクリックして、代替 phpunit.xml 設定ファイル(英語)へのパスを指定します。

デフォルトの構成ファイルを使用するには、チェックボックスを選択解除したままにしておきます。

Pest のデフォルト構成ファイルが テストフレームワーク ページに設定されているかどうかを簡単に確認するには、フィールドの右側にある をクリックします。

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

このフィールドでは、テストの実行時に Pest に渡すオプションを指定します。 利用可能なオプションの完全なリストについては、「Pest のドキュメント(英語) 」を参照してください。

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

優先カバレッジエンジン

このリストから、構成済みのコードカバレッジランナーの 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

  詳細は、 Karma を参照してください。

• 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 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 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

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

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