Codeception

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

• Download codeception.phar at the Codeceptionインストールページ(英語) and save it under the root of the project where Codeception will be later used.

  You can also save codeception.phar in a different location and configure it as an include path. In either case, PhpStorm will include codeception.phar in indexing, so it will successfully resolve references to the Codeception classes and thus provide you with full coding assistance.

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

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

2. 以下のいずれか 1 つを実行します:

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

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

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

Codeceptionを自動的に設定する

1. Store the codeception.yml or codeception.yml.dist configuration file under the project root.

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

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

Codeceptionを手動で設定する

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

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

   

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

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

     

2. In the Codeceptionライブラリ area, specify the location of the Codeception executable file or codeception.phar archive in the target environment. For example, if you installed Codeception through Composer, the executable file is stored in vendor/bin/codecept . Click next to the Codeceptionディレクトリまたはpharファイルへのパス field. PhpStorm detects the version of Codeception and displays it below the field.

3. In the テスト・ランナー area, appoint the configuration YML file to use for launching and executing scenarios.

   By default, Codeception looks for a codeception.yml configuration file in the project root folder. You can appoint a custom configuration file.

   • Clear the デフォルト構成ファイル checkbox to have Codeception use the codeception.yml configuration file from the project root folder. If no such file is found, test execution fails, therefore it may be more reliable to specify the configuration file explicitly.

   • Select the デフォルト構成ファイル checkbox to specify your own YML configuration file. This file will be later used as default in all Codeception run/debug configurations.

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

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

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

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

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

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

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

   

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

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

   • The name of the test class. PhpStorm automatically composes the name from the production class name as <production class>Test.php (for Codeception ユニット・テスト ) or <production class>Cest.php (for Codeception 機能テスト ) .

   • The folder for the test class file, which is automatically suggested based on the containing directory and namespace of the production class, the configured test sources root and its psr-4パッケージプレフィックス , or the tests value specified in the codeception.yml(英語) configuration file.

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

   • The namespace the test class will belong to, which is automatically suggested based on the containing directory and namespace of the production class, the configured test sources root and its psr-4パッケージプレフィックス , or the namespace value specified in the codeception.yml(英語) configuration file.

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

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

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

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

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

  

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

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

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

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

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

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

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

2. 開く実行/デバッグ構成: Codeceptionダイアログで、実行するシナリオを指定し、使用するPHP インタープリターを選択し、PHP実行可能ファイルに渡すオプションと引数を指定してその動作をカスタマイズします。