Codeception
PhpStorm は、Codeception テストフレームワーク(英語)バージョン 2.2.0 以降でユニット、機能、および受け入れテストを実行するためのサポートを提供します。
始める前に
ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成の説明に従って、PHP インタープリターが PHP ページの PhpStorm に設定されていることを確認してください。
Codeception をダウンロードしてインストールする
開始する前に、Composer がマシンにインストールされ、Composer 依存関係マネージャーに従って現在のプロジェクトで初期化されていることを確認してください。
Codeception を手動でダウンロードしてインストールする
codeception.phar を Codeception インストールページ(英語)からダウンロードし、Codeception が後で使用されるプロジェクトのルートに保存します。
codeception.phar を別の場所に保存してインクルードパスとして設定することもできます。どちらの場合も、PhpStorm は codeception.phar を索引付けに含めるため、Codeception クラスへの参照を正常に解決し、それによって完全なコーディング支援を提供します。
Composer を使用して Codeception をダウンロードしてインストールする
composer.json 内で、codeception / codeception 依存関係レコードを
require
またはrequire-dev
セクションに追加します。 Ctrl+Space を押して、パッケージ名とバージョンのコード補完を取得します。以下のいずれか 1 つを実行します:
エディターパネルの上部にあるインストールショートカットリンクをクリックします。
インストールされていない Composer パッケージインスペクションが有効になっている場合、PhpStorm は、現在インストールされていない宣言済みの依存関係をハイライトします。 Alt+Enter を押して、特定の依存関係をインストールするか、すべての依存関係を一度にインストールするかを選択します。
Codeception 公式サイト(英語)から Codeception をインストールする方法の詳細を参照してください。
composer.json エディターガターのパッケージレコードの横にあるをクリックして、対応する設定 / 環境設定ページにジャンプし、Codeception を手動で構成します。

プロジェクトで Codeception を PhpStorm と統合する
ローカルの PHP インタープリターを使用する場合、PhpStorm は Codeception の初期構成を自動的に実行します。リモート PHP インタープリターの場合、手動の 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 を自動的に設定する
codeception.yml または codeception.yml.dist 構成ファイルをプロジェクトルートに保存します。
PhpStorm はテストフレームワークページおよび Codeception 実行 / デバッグ構成上にローカルフレームワーク構成を作成します。
Codeception を手動で設定する
設定 / 環境設定ダイアログ Ctrl+Alt+S で、 ノードを展開し、 で を選択します。
開いているテストフレームワークページの中央ペインで
をクリックし、リストから設定タイプを選択します。
ローカル設定では、デフォルトのプロジェクト PHP インタープリターが使用されます。詳細はデフォルトのプロジェクト CLI インタープリターを参照してください。
リモート PHP インタープリターで Codeception を使用するには、表示されるダイアログで以下のいずれかの設定を選択します。
Codeception ライブラリ領域で、ターゲット環境内の Codeception 実行可能ファイルまたは codeception.phar アーカイブの場所を指定します。例:Composer から Codeception をインストールした場合、実行可能ファイルは vendor/bin/codecept に保存されます。Codeception ディレクトリまたは phar ファイルへのパスフィールドの横にある
をクリックします。PhpStorm は Codeception のバージョンを検出し、それをフィールドに表示します。
テストランナー領域で、シナリオの起動と実行に使用する構成 YML ファイルを指定します。
デフォルトでは、Codeception はプロジェクトのルートフォルダー内の codeception.yml 設定ファイルを探します。カスタム構成ファイルを指定できます。
デフォルト構成ファイルチェックボックスをオフにすると、Codeception はプロジェクトルートフォルダーの codeception.yml 設定ファイルを使用します。そのようなファイルが見つからない場合、テストの実行は失敗します。構成ファイルを明示的に指定する方が信頼性が高い場合があります。
デフォルト構成ファイルチェックボックスを選択して、独自の YML 設定ファイルを指定します。このファイルは、後ですべての Codeception 実行 / デバッグ構成でデフォルトとして使用されます。
このフィールドで、使用する構成ファイルの場所を指定します。手動でパスを入力するか、
をクリックして表示されるダイアログでファイルを選択します。
クラスの Codeception テストを生成する
次のいずれかを実行して新しい PHP テストを作成するダイアログを開きます。
メインメニューからPHP テスト | Codeception ユニットテストまたは PHP テスト | Codeception 機能テストを選択します。
を選択します。次に、コンテキストメニューからプロジェクトツールウィンドウで、Alt+Insert を押すか、テストする PHP クラスを右クリックし、新規 | PHP テスト | Codeception ユニットテストまたは新規 | PHP テスト | Codeception 機能テストを選択します。
テストする PHP クラスのエディターで、クラスの定義にキャレットを配置します。次に、Alt+Enter を押して、ポップアップメニューから新規テストの作成を選択します。このようにして、単一の PHP ファイル内の複数のクラス間で定義された PHP クラスのテストを生成できます。
特定のメソッドのテストを作成するには、メソッド宣言内にキャレットを配置します。選択したメソッドは、新しい PHP テストを作成するダイアログのメソッドリストで自動的に選択されます。
新しい 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 テストの実行とデバッグ
Codeception テストの記述については、ユニットテスト(英語)、受け入れテスト(英語)、機能テスト(英語)を参照してください。
Codeception テストの実行またはデバッグ
プロジェクトツールウィンドウで、テストを実行するファイルまたはフォルダーを選択し、選択したコンテキストメニューから実行 '<file or folder>' またはデバッグ '<file or folder>' を選択します。
PhpStorm はデフォルトの実行構成を生成し、実行 / デバッグテストセッションを開始します。
自動的に生成されたデフォルト設定を保存する
テストセッションが終了したら、ファイルまたはフォルダーのコンテキストメニューから保存 <default_test_configuration_name> を選択します。
以前に保存された実行 / デバッグ構成によってテストを実行またはデバッグする
ツールバーのリストから必要な Codeception 構成を選択し、
または
をクリックします。
カスタム実行 / デバッグ構成を作成する
プロジェクトツールウィンドウで、実行するテストが含まれているファイルまたはフォルダーを選択し、コンテキストメニューから実行構成の作成を選択します。または、メインメニューから を選択してから
をクリックし、リストから Codeception を選択します。
開く Codeception ダイアログで、実行するシナリオを指定し、使用する PHP インタープリターを選択し、PHP 実行可能ファイルに渡すオプションと引数を指定してその動作をカスタマイズします。
テスト結果を監視する
PhpStorm は実行ツールウィンドウのテストランナータブにおけるテスト実行結果を示します。

このタブは大きく 2 つのエリアに分かれています。
左側の領域では、すべての単体テストをドリルダウンして、成功したテストと失敗したテストを確認できます。テストのフィルタリング、結果のエクスポート、コンテキストメニューコマンドを使用して特定のテストを実行したりソースコードに移動したりできます。
右側の領域には、生の Codeception 出力が表示されます。
Codeception テストを自動的に実行する
影響を受けるコードが変更された場合、自動的に PhpStorm を再実行することができます。このオプションは、実行 / デバッグ構成ごとに構成され、この実行 / デバッグ構成で指定されたテスト範囲に応じて、テスト、テストファイル、フォルダー、またはテストの複合選択に適用できます。
テストを実行します。
テストランナータブで、ツールバーの
トグルボタンを押します。
必要に応じて、
ボタンをクリックして、コードの変更時にテストを開始するための遅延時間を設定します。
関連ページ:

ローカル PHP インタープリターを構成する
ローカル PHP インタープリターは、リモート PHP インタープリターの反対側にコンピューターにインストールされた PHP エンジンであり、リモートホストまたはVagrantインスタンスにセットアップされた仮想環境にインストールできます。リモート PHP インタープリターの構成を参照してください。...

リモート PHP インタープリターの構成
リモート PHP インタープリターという用語は、リモートホストまたは仮想環境にインストールされた PHP エンジンを意味します。リモート PHP インタープリターという用語は、コンピューターにインストールされているローカル PHP インタープリターの反対語として使用されます。ローカル PHP インタ...

Composer 依存関係マネージャー
PhpStorm はComposer依存関係マネージャーと統合されます。これにより、Packagistまたはカスタムリポジトリからのパッケージをプロジェクトの依存関係として宣言し、IDE から管理できます。PhpStorm は、composer.jsonを操作するための包括的なコーディング支援と、一...

テストフレームワーク
このページを使用して、PHP 固有のテストフレームワークと現在のプロジェクトの PhpStorm を統合します。PhpStorm を使用すると、PHPUnit、Behat、Codeception、PHPSpecテストを実行およびデバッグできます。ページは 2 つのペインで構成されています。中央ペイン...

Codeception
このダイアログは、PHPとCodeceptionプラグインが有効になっている場合にのみ利用可能です。プラグインはデフォルトで有効になっています。プラグインが無効になっている場合は、プラグインを管理する説明に従ってプラグインページで有効にします。このダイアログを使用して、Codeceptionフレーム...

コンテンツルート内のフォルダーの構成
コンテンツルート内では、PhpStormはソースコードを含むフォルダーと、検索、解析、監視などの際に無視されるフォルダーを区別できます。さまざまなタイプのフォルダーを区別するには、コンテンツルートのフォルダーをソースフォルダーまたは除外フォルダーとしてマークします。コンテンツルート内では、PhpSt...