Pest

PhpStorm から Pest をインストールするには：

1. composer.json 内で、 pestphp/pest 依存関係レコードを require キーまたは require-dev キーに追加します。 パッケージ名とバージョンのコード補完を取得するには、 Ctrl+Space を押します。

2. 次のいずれかを実行します：

   • エディターパネルの上部にある インストール​する​ ショートカットリンクをクリックします。

   • インストールされていない Composer パッケージ インスペクションが有効化されている場合、PhpStorm は現在インストールされていない宣言済みの依存関係をハイライトします。 Alt+Enter を押して、特定の依存関係をインストールするか、すべての依存関係を一度にインストールするかを選択します。

3. ターミナル ツールウィンドウで、 ./vendor/bin/pest --init コマンドを実行して現在の PHP プロジェクトで Pest を初期化し、サンプルテストファイルを含む テスト フォルダーと phpunit.xml 構成ファイルをテストスイートのルートレベルに追加します。

Pest を自動的に設定する

プロジェクトに Pest をインストールすると、PhpStorm はインストール済みの Pest 実行可能ファイルを検出し、 テストフレームワークページにテストフレームワーク構成を作成します。

phpunit.xml または phpunit.xml.dist 構成ファイルがプロジェクト（またはサブプロジェクト）のルートに自動的に検出されるか、 手動構成時に明示的に指定された場合、PhpStorm は対応する Pest 実行 / デバッグ構成 も作成します。

Pest を手動で設定する

1. 設定 ダイアログ（Ctrl+Alt+S ）で、 PHP | テストフレームワーク に移動します。

   開いている テストフレームワークページの中央ペインで をクリックし、リストから設定タイプを選択します。

   

   • ローカル構成では、デフォルトのプロジェクト PHP インタープリターが使用されます。 詳細については、 デフォルトのプロジェクト CLI インタープリターを参照してください。

   • リモート PHP インタープリターで Pest を使用するには、表示されるダイアログで以下のいずれかの設定を選択します。

     

2. テストランナー 領域で、シナリオの起動と実行に使用する構成 XML ファイルへのパスを設定します。

1. エディターで、テストする PHP クラスの定義にキャレットを置き、 Alt+Enter を押して、ポップアップメニューから 新規テストの作成 を選択します。 この方法で、単一の PHP ファイル内の複数のクラス間で定義された PHP クラスのテストを生成できます。

   特定のメソッドのテストを作成するには、メソッド宣言内にキャレットを置きます。 選択したメソッドは、 新しい PHP テストを作成する ダイアログのメソッドのリストから自動的に選択されます。

2. 開いた 新しい PHP テストを作成する ダイアログで、生成されたテストのパラメーターを指定します。

   

   • テストファイルテンプレート ：PhpStorm がテストクラスを生成する際のテンプレートです。 リストから Pest が選択されていることを確認します。

   • 命名: テストクラスの名前。 PhpStorm は本番クラス名から名前を自動的に作成します。

   • ディレクトリ: テストクラスファイルのフォルダーは、本番クラスのディレクトリや名前空間、設定された テストソースルートや PSR-4 パッケージプレフィックス 、構成ファイルで指定された値に基づき自動的に提案されます。

     別のフォルダーを指定するには、 ディレクトリ フィールドの横にある をクリックし、該当するフォルダーを選択します。

   • 名前空間: テストクラスが属する名前空間は、本番クラスのディレクトリや名前空間、設定された テストソースルートや psr-4 パッケージプレフィックスに基づき自動的に提案されます。

   • メンバー: テストメソッドスタブを生成する製品クラスメソッドのリスト。 必要な製品クラスメソッドの横にあるチェックボックスをオンにします。 親クラスから継承されたメソッドを含めるには、 継承メソッドの表示 チェックボックスをオンにします。

     PhpStorm は、テストメソッドの名前を test<production method> として自動的に作成します。 テストメソッドスタブの生成に使用されるコードテンプレートは、 ファイルおよびコードテンプレート 設定ページの コード タブでカスタマイズできます。

テストが作成されたら、 移動 | テスト対象に移動 を選択して実稼働クラスに戻ることができます。 詳細については、 テストとそのテスト対象の間を移動する を参照してください。

Pest テストの実行またはデバッグ

PhpStorm で Pest テストを実行するための代替方法がいくつかあります：

• プロジェクト ツールウィンドウから: テストを実行するファイルまたはフォルダーを選択し、選択したコンテキストメニューから 実行 '<ファイルまたはフォルダー>'；、 デバッグ '<ファイルまたはフォルダー>'； 、または さらに実行 / デバッグ を選択します。

  

• ファイルエディターウィンドウから: エディターでテストファイルを開き、テストの横のガターにある をクリックして、コンテキストメニューから 実行 '<test_name>'；、 デバッグ '<test_name>'；、 '<test_name>' を並列で実行する、 ミューテーションを使用して '<test_name>' を実行する を選択します。

  または、対応する行にキャレットを置いて Ctrl+Shift+F10 を押します。

  

• Run ウィジェットから：ドロップダウンリストから 現在のファイル を選択し、 または をクリックして現在開いているテストファイルを実行またはデバッグできます。また、 をクリックして '<test_name>' を並列で実行する または ミューテーションを使用して '<test_name>' を実行する オプションを選択できます。

  

PhpStorm はデフォルトの実行構成を生成し、それを使って実行または デバッグテストセッションを開始します。

一時停止した実行を再開する

Pest 4.0 以降では、 debug() 方式によるブラウザーテスト(英語)を実行すると実行が一時停止され、ブラウザーウィンドウが開きます。 PhpStorm でテスト実行を再開するには、ツールバーの「テスト実行を続行 」ボタンをクリックしてください。

Pest テストを移動する

テストファイル内の特定のテストに素早く移動するには、 ファイル構造ビューを利用してください。 開いているファイル内の任意の場所にキャレットを置き、 Ctrl+F12 を押して ファイル構造 ポップアップを開きます。

Alt+7 を押すと、 構造 ツールウィンドウでファイル構造が開きます。

設定を永続的に保存する

• テストセッションが終了したら、実行ウィジェットのそれぞれの実行 / デバッグ構成のコンテキストメニューから 構成の保存 を選択します。

  

保存した実行 / デバッグ構成を実行する

• ツールバーのリストから必要な Pest 構成を選択し、 または をクリックします。

カスタム実行 / デバッグ構成を作成する

1. プロジェクト ツールウィンドウで、実行するテストが含まれるファイルまたはフォルダーを選択し、コンテキストメニューから 実行構成の作成 を選択します。 あるいは、メインメニューで 実行 | 実行構成の編集 に移動し、 をクリックしてリストから Pest を選択します。

2. 開いた Pest ダイアログで、実行するシナリオを指定し、使用する PHP インタープリターを選び、PHP 実行可能ファイルに渡すオプションや引数を指定して動作をカスタマイズします。

1. テストを実行します。

2. 実行 ツールバーで、 自動的に再実行 をクリックします。

   

3. オプションで、コードの変更時にテストを開始するまでの遅延時間を設定します。 これを行うには、 実行 ツールバーで をクリックし、 テストランナーの設定 | 自動テスト遅延の設定 を選択します。