Codeceptionによるテスト

Codeceptionを手動でダウンロードしてインストールする

• codeception.phar をCodeceptionインストールページ(英語)からダウンロードし、Codeceptionが後で使用されるプロジェクトのルートに保存します。

  codeception.phar を別の場所に保存してインクルードパスとして設定することもできます。どちらの場合も、PhpStormは codeception.phar を索引付けに含めるため、Codeceptionクラスへの参照を正常に解決し、それによって完全なコーディング支援を提供します。

Composerを使用してCodeceptionをダウンロードしてインストールする

1. composer.jsonのコンテキストメニューから、Composer | 依存性の管理を選択します。あるいは、メインメニューからツール | Composer | 依存性の管理を選択してください。

2. 開いたComposerの依存関係を管理するダイアログで、使用可能なパッケージ リストからcodeception / codeceptionパッケージを選択します。おそらく検索フィールドを使用します。

   インストールするバージョンリストから該当するバージョンを選択します。

3. 必要に応じて、設定隠し領域を展開し、拡張インストールオプションを指定します。コマンド・ライン・パラメーターフィールドに、追加のコマンドラインパラメータを入力します。

4. インストールをクリックします。

Codeception公式サイト(英語)からCodeceptionをインストールする方法の詳細を参照してください。

Codeceptionを自動的に設定する

1. codeception.yml または codeception.yml.dist 構成ファイルをプロジェクトルートに保存します。

2. ComposerとCodeceptionをインストール。

PhpStormはテストフレームワークページおよびCodeception実行/デバッグ構成上にローカルフレームワーク構成を作成します。

Codeceptionを手動で設定する

1. 設定/環境設定ダイアログ（Ctrl+Alt+S）で、言語とフレームワークノードを展開し、PHPにあるテスト・フレームワークを選択します。

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

   

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

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

     

2. Codeceptionライブラリー領域で、ターゲット環境内のCodeception実行可能ファイルまたは codeception.phar アーカイブの場所を指定します。例：ComposerからCodeceptionをインストールした場合、実行可能ファイルは vendor/bin/codeceptに保存されます。Codeceptionディレクトリーまたはpharファイルへのパスフィールドの横にある をクリックします。PhpStormはCodeceptionのバージョンを検出し、それをフィールドに表示します。

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

   デフォルトでは、Codeceptionはプロジェクトのルートフォルダー内の codeception.yml 設定ファイルを探します。カスタム構成ファイルを指定できます。

   • デフォルト構成ファイルチェックボックスをオフにすると、Codeceptionはプロジェクトルートフォルダーの codeception.yml 設定ファイルを使用します。そのようなファイルが見つからない場合、テストの実行は失敗します。構成ファイルを明示的に指定する方が信頼性が高い場合があります。

   • デフォルト構成ファイルチェックボックスを選択して、独自の YML 設定ファイルを指定します。このファイルは、後ですべてのCodeception実行/デバッグ設定でデフォルトとして使用されます。

     このフィールドで、使用する構成ファイルの場所を指定します。手動でパスを入力するか、 をクリックして表示されるダイアログでファイルを選択します。

1. 次のいずれかを実行して新しいPHPテストを作成するダイアログを開きます。

   • メインメニューからファイル | 新規を選択します。次に、コンテキストメニューからPHP テスト | Codeception ユニット・テストまたはPHP テスト | Codeception 機能テストを選択します。

   • プロジェクトツールウィンドウで、Alt+Insert を押すか、テストするPHPクラスを右クリックし、新規 | PHP テスト | Codeception ユニット・テストまたは新規 | PHP テスト | Codeception 機能テストを選択します。

   • テストするPHPクラスのエディターで、クラスの定義内にキャレットを置きます。次に、コンテキストメニューからジャンプ | テストを選択するか、または Ctrl+Shift+T を押してポップアップメニューから新規テストの作成を選択します。このようにして、単一のPHPファイル内の複数のクラス間で定義されたPHPクラスのテストを生成できます。

     特定のメソッドのテストを作成するには、メソッド宣言内にキャレットを配置します。選択した方法は、新しいPHPテストを作成するダイアログの次のテスト・メソッドを生成領域で自動的に選択されます。

2. 新しいPHPテストを作成するダイアログが開きます。

   

   生成されたテストのパラメータを提供する：

   • テストファイルテンプレート、つまりPhpStormがテストクラスを生成するためのテンプレート。テストファイルテンプレートリストでCodeceptionユニットまたはCodeception機能性が選択されていることを確認してください。

   • テストするクラスの完全修飾名。この名前は、テスト・クラス名の提案に使用されます。デフォルトでは、名前ボックスには、テスト生成が呼び出されたクラスの名前が表示されます。完了を使用するには、Ctrl+Spaceを押します。

   • テストクラスの名前。PhpStormは、<production class>Test.php （Codeception ユニット・テストの場合）または <production class>Cest.php （Codeception 機能テストの場合）としてプロダクションクラス名から名前を自動的に作成します。テストクラス名は、テスト・クラス領域の名前フィールドに表示されます。

   • テストクラスのフォルダー。デフォルトでは、テストソースのルートとしてマークされているフォルダーです。そのようなフォルダーが指定されていない場合は、プロダクションクラスを含むフォルダーが代わりに提案されます。

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

   • テストメソッドスタブを生成するための本番クラスメソッド。次のテスト・メソッドを生成領域で、必要な本番クラスメソッドの横にあるチェックボックスを選択します。親クラスから継承したメソッドを含めるには、継承されたメソッドを表示するチェックボックスを選択します。

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

3. 定義済みの設定を確認、承認、または更新し、OKをクリックしてテスト生成を開始します。

テストが完了したら、ナビゲート | テスト対象にジャンプを選択して本番クラスに戻ることができます。詳細は、テストとテスト対象間の移動を参照してください。

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

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

  

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

自動的に生成されたデフォルト設定を保存する

• テストセッションが終了したら、ファイルまたはフォルダーのコンテキストメニューから保存<default_test_configuration_name>を選択します。

以前に保存された実行/デバッグ設定によってテストを実行またはデバッグする

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

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

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

2. 開いている実行/デバッグ構成: Codeceptionダイアログで、PHP実行ファイルに渡すオプションと引数を指定して、現在のPHP インタープリターの動作を実行およびカスタマイズするシナリオを指定します。