Codeception

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

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

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

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

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

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

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

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

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

composer.json エディターのガター内のパッケージレコードの横にある をクリックすると、対応する設定ページが表示され、そこで Codeception を手動で構成できます。

codeception.yml 設定ファイルを生成する

Codeception をインストールしたら、codeception.yml 設定ファイルを生成してプロジェクトで初期化する必要があります。

• ビルトイン PhpStorm ターミナル Alt+F12 を開き、コマンドプロンプトで、インストールモードと現在のオペレーティングシステムに応じて、次のコマンドのいずれかを入力します。

  • プロジェクトに codeception.phar をインストールした場合は、Windows の場合は php codecept.phar bootstrap、Linux の場合は macOS または codecept bootstrap と入力します。

  • Composer を介して Codeception をグローバルにインストールした場合は、すべてのプラットフォームで codecept bootstrap と入力します。

Codeception を自動的に設定する

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

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

PhpStorm は、インストールされている Codeception 実行可能ファイル (プロジェクトに指定された Codeception 依存関係を持つ Composer が管理するサブプロジェクトがある場合は複数の実行可能ファイル) を検出し、インストールされている各 Codeception 実行可能ファイルごとにテストフレームワーク構成をテストフレームワークページに作成します。

codeception.yml または codeception.dist.yml 構成ファイルがプロジェクト (またはサブプロジェクト) ルートで自動的に検出された場合、または手動構成中に明示的に指定された場合、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.dist.yml 構成ファイルを検索します。カスタム構成ファイルを指定できます。

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

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

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

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

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

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

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

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

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

   

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

   • 名前 : テストクラスの名前。PhpStorm は、実動クラス名から <production class>Test.php (Codeception ユニットテストの場合) または <production class>Cest.php (Codeception 機能テストの場合) として名前を自動的に作成します。

   • ディレクトリ : テストクラスファイルのフォルダー。これは、本番クラスの格納ディレクトリと名前空間、構成されたテストソースルートとその PSR-4 パッケージ接頭辞、または codeception.yml(英語) 構成ファイルで指定された tests 値に基づいて自動的に提案されます。

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

   • 名前空間 : テストクラスが属する名前空間。これは、本番クラスの格納ディレクトリと名前空間、構成されたテストソースルートとその psr-4 パッケージ接頭辞、または codeception.yml(英語) 構成ファイルで指定された namespace 値に基づいて自動的に提案されます。

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

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

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

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

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

  

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

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

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

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

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

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

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

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

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

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

   

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