テストフレームワーク
このページを使用して、現在のプロジェクトで PHP テストフレームワークを PhpStorm と統合します。 PhpStorm を利用すると、 PHPUnit、 Behat、 PHPSpec、 Codeception、 Pest テストを実行およびデバッグできます。
プロジェクトでテストフレームワークを設定する
をクリックし、テストフレームワークとそれを実行する PHP インタープリターを選択します。
リモートの設定では、設定済みの PHP インタープリターのいずれかを選択します:
右側のペインで、テストフレームワークをどこから取得するかを選択します。
Behat、PHPSpec、Codeception の場合は、フレームワークの実行可能ファイルへのパスを入力します。
PHPUnit については、利用しているフレームワークのインストールタイプを指定してください。利用可能なオプションは composer オートローダー、 autoload.php または phpunit.phar アーカイブです。
選択したリモート PHP インタープリターとパスのマッピングを確認してください。
必要に応じて、構成ファイルを指定します。 PHPUnit では、使用するブートストラップファイルを指定することもできます。
PHPUnit
このペインでは、PHP インタープリターで使用する PHPUnit のインストールを設定します。
PHPUnit ライブラリ
この領域に、PHPUnit のインストールのタイプを指定します。 使用可能なオプションは次のとおりです。
Composer オートローダーを使用する | Composer 依存関係マネージャー がインストールした PHPUnit を実行するには、このオプションを選択します。 パッケージは、 vendor フォルダーから autoload.php ファイルによって読み込まれ、ロードされます。 スクリプトのパス フィールドに autoload.php の位置を指定します。 |
phpunit.phar のパス | phar アーカイブから PHPUnit を実行するには、このオプションを選択します。
|
テストランナー
この領域では、PhpStorm から PHPUnit テストを起動する際に使用する XML 構成ファイルへのパスを指定します。
テストを起動する前に常に PHP スクリプトが実行されるように、ブートストラップファイルへのパスを指定することもできます。
デフォルト構成ファイル | すべての PHPUnit 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される phpunit.xml または phpunit.xml.dist ファイルへのパスを指定するには、このチェックボックスを選択します。 編集時に、特定の PHPUnit 実行 / デバッグ構成の代替構成ファイルを提供できることに注意してください。 XML 構成ファイルが指定されていない場合、PhpStorm はデフォルトで |
デフォルトブートストラップファイル | テストを起動する前に常に PHP スクリプトを実行するには、このチェックボックスをオンにします。 フィールドで、スクリプトの場所を指定します。 パスを手動で入力するか、 |
CLI インタープリター | PHPUnit を使用するためのリモート PHP CLI インタープリター。 CLI インタープリター フィールドは読み取り専用です。 |
パスマッピング | ローカルソースと、Vagrant インスタンス、Docker コンテナー、またはリモートホスト上のソース間のパスマッピング。 ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。 あるいは、フィールドの横にある |
Docker コンテナー | イメージからコンテナーを起動するために使用される Docker コンテナーの設定。 これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれる場合があります。 |
をクリックすると、 PHPUnit ライブラリ
この領域に、PHPUnit のインストールのタイプを指定します。 使用可能なオプションは次のとおりです。
Composer オートローダーを使用する | Composer 依存関係マネージャー がインストールした PHPUnit を実行するには、このオプションを選択します。 パッケージは、 vendor フォルダーから autoload.php ファイルによって読み込まれ、ロードされます。 スクリプトのパス フィールドに autoload.php の位置を指定します。 |
phpunit.phar のパス | phar アーカイブから PHPUnit を実行するには、このオプションを選択します。
|
テストランナー
この領域では、シナリオの起動と実行に使用する構成 XML ファイルへのパスを設定します。
ブートストラップファイルへのパスを入力して、テストを起動する前に常に PHP スクリプトを実行することもできます。 フィールドで、スクリプトの場所を指定します。 パスを手動で入力するか、 
をクリックして 表示されるダイアログで目的のフォルダーを選択してください。
デフォルト構成ファイル | すべての PHPUnit 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される phpunit.xml または phpunit.xml.dist ファイルへのパスを指定するには、このチェックボックスを選択します。 編集時に、特定の PHPUnit 実行 / デバッグ構成の代替構成ファイルを提供できることに注意してください。 XML 構成ファイルが指定されていない場合、PhpStorm はデフォルトで チェックボックスをオフにすると、PHPUnit はプロジェクトのルートフォルダーにある phpunit.xml または phpunit.xml.dist 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
デフォルトブートストラップファイル | テストを起動する前に常に PHP スクリプトを実行するには、このチェックボックスをオンにします。 フィールドで、スクリプトの場所を指定します。 パスを手動で入力するか、 |
Behat
このペインでは、構成済みのローカルおよびリモート PHP インタープリターを介して利用可能な Behat(英語) フレームワークのインストールを設定します。
Behat ライブラリ
この領域に、使用する Behat インストールを指定します。
Behat 実行可能ファイルへのパス | このフィールドで、 behat.phar アーカイブの場所、Behat 実行可能ファイルのあるフォルダーを指定します。 Behat は必ずしも現在のプロジェクトルートにインストールする必要はありません。 手動でパスを入力するか、 |
Behat リリース | このリンクをクリックすると、GitHub の Behat リポジトリに移動し、関連するバージョンの behat.phar アーカイブを選択できます。 |
Behat バージョン | この読み取り専用フィールドには、指定した Behat インストールのバージョンが表示されます。 リフレッシュアイコン |
をクリックすると、PhpStorm がバージョンを検出します。 デフォルト値は テストランナー
この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。
デフォルト構成ファイル | すべての Behat 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。 チェックボックスをオフにすると、Behat はプロジェクトのルートフォルダーにある behat.yml または behat.yml.dist 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
CLI インタープリター | Behat を使用するためのリモート PHP CLI インタープリター。 CLI インタープリター フィールドは読み取り専用です。 |
パスマッピング | ローカルソースと、Vagrant インスタンス、Docker コンテナー、またはリモートホスト上のソース間のパスマッピング。 ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。 あるいは、フィールドの横にある |
Docker コンテナー | イメージからコンテナーを起動するために使用される Docker コンテナーの設定。 これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれる場合があります。 |
Behat ライブラリ
この領域に、使用する Behat インストールを指定します。
Behat 実行可能ファイルへのパス | このフィールドで、 behat.phar アーカイブの場所、Behat 実行可能ファイルのあるフォルダーを指定します。 Behat は必ずしも現在のプロジェクトルートにインストールする必要はありません。 手動でパスを入力するか、 |
Behat リリース | このリンクをクリックすると、GitHub の Behat リポジトリに移動し、関連するバージョンの behat.phar アーカイブを選択できます。 |
Behat バージョン | この読み取り専用フィールドには、指定した Behat インストールのバージョンが表示されます。 リフレッシュアイコン |
テストランナー
この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。
デフォルト構成ファイル | すべての Behat 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。 チェックボックスをオフにすると、Behat はプロジェクトのルートフォルダーにある behat.yml または behat.yml.dist 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
PHPSpec
このペインでは、構成済みのローカルおよびリモート PHP インタープリターを介して利用可能な PHPSpec(英語) ツールセットのインストールを設定します。
PHPSpec ライブラリ
この領域に、使用する PHPSpec のインストールを指定します。
PHPSpec 実行ファイルへのパス | このフィールドに、 phpspec の場所を指定します。 PHPSpec は必ずしも現在のプロジェクトルートにインストールする必要はありません。 ローカルインタープリターに PHPSpec へのパスが指定されていない場合、PhpStorm は PHPSpec の完全なサポートを提供しません。たとえば、コード補完の候補を表示したり、参照を解決したりしません。 |
接頭辞 ('spec_prefix' ) | この読み取り専用フィールドには、仕様の名前空間接頭辞が表示されます。 PhpStorm は、 デフォルト構成ファイル フィールドで指定された構成ファイルから |
テストランナー
この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。
デフォルト構成ファイル | すべての PHPSpec 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。 チェックボックスをオフにすると、PHPSpec はプロジェクトのルートフォルダーにある phpspec.yml または phpspec.yml.dist 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
CLI インタープリター | PHPSpec を使用するためのリモート PHP CLI インタープリター。 CLI インタープリター フィールドは読み取り専用です。 |
パスマッピング | ローカルソースと、Vagrant インスタンス、Docker コンテナー、またはリモートホスト上のソース間のパスマッピング。 ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。 あるいは、フィールドの横にある |
Docker コンテナー | イメージからコンテナーを起動するために使用される Docker コンテナーの設定。 これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれる場合があります。 |
PHPSpec ライブラリ
この領域に、使用する PHPSpec のインストールを指定します。
PHPSpec 実行ファイルへのパス | このフィールドに、 phpspec の場所を指定します。 PHPSpec は必ずしも現在のプロジェクトルートにインストールする必要はありません。 ローカルインタープリターに PHPSpec へのパスが指定されていない場合、PhpStorm は PHPSpec の完全なサポートを提供しません。たとえば、コード補完の候補を表示したり、参照を解決したりしません。 |
テストランナー
この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。
デフォルト構成ファイル | すべての PHPSpec 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。 チェックボックスをオフにすると、PHPSpec はプロジェクトのルートフォルダーにある phpspec.yml または phpspec.yml.dist 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
Codeception
このペインでは、構成済みのローカルおよびリモート PHP インタープリターを介して利用可能な Codeception(英語) フレームワークのインストールを設定します。
Codeception ライブラリ
この領域に、使用する Codeception インストールを指定します。
Codeception 実行可能ファイルへのパス | このフィールドで、 codeception.phar アーカイブの場所、Codeception 実行可能ファイルのあるフォルダーを指定します。 |
Codeception リリース | このリンクをクリックすると、GitHub の Codeception リポジトリに移動し、関連するバージョンの codeception.phar アーカイブを選択できます。 |
Codeception バージョン | この読み取り専用フィールドは、指定された Codeception インストールのバージョンを表示します。 |
テストランナー
この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。
デフォルト構成ファイル | すべての Codeception 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。 チェックボックスをオフにすると、Codeception はプロジェクトのルートフォルダーにある codeception.yml または codeception.dist.yml 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
CLI インタープリター | Codeception を使用するためのリモート PHP CLI インタープリター。 CLI インタープリター フィールドは読み取り専用です。 |
パスマッピング | ローカルソースと、Vagrant インスタンス、Docker コンテナー、またはリモートホスト上のソース間のパスマッピング。 ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。 あるいは、フィールドの横にある |
Docker コンテナー | イメージからコンテナーを起動するために使用される Docker コンテナーの設定。 これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれる場合があります。 |
Codeception ライブラリ
この領域に、使用する Codeception インストールを指定します。
Codeception 実行可能ファイルへのパス | このフィールドで、 codeception.phar アーカイブの場所、Codeception 実行可能ファイルのあるフォルダーを指定します。 |
Codeception リリース | このリンクをクリックすると、GitHub の Codeception リポジトリに移動し、関連するバージョンの codeception.phar アーカイブを選択できます。 |
Codeception バージョン | この読み取り専用フィールドは、指定された Codeception インストールのバージョンを表示します。 |
テストランナー
この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。
デフォルト構成ファイル | すべての Codeception 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。 チェックボックスをオフにすると、Codeception はプロジェクトのルートフォルダーにある codeception.yml または codeception.dist.yml 設定ファイルを使用します。 該当するファイルが見つからない場合、テスト実行は失敗します。 そのため、設定ファイルを明示的に指定した方が確実です。 |
Pest
このペインでは、構成されたローカルおよびリモート PHP インタープリターを通じて利用可能な Pest(英語) テストフレームワークのインストールを構成します。
Pest ライブラリ
Pest 実行可能ファイルへのパス | pest 実行可能ファイルへの絶対パス。 Composer を利用してプロジェクトに Pest の依存関係をインストールすると、PhpStorm はインストールされた Pest 実行可能ファイルを自動的に検出します。 |
をクリックし、開いたダイアログで関連する場所を選択します。テストランナー
デフォルト構成ファイル | デフォルトでは、PhpStorm はプロジェクトのルートフォルダー内の phpunit.xml または phpunit.xml.dist 構成ファイルを検出して使用します。 カスタム構成ファイルを使用するには、チェックボックスをオンにして、使用する構成ファイルの場所を指定します。 パスを手動で入力するか、 |
CLI インタープリター | Pest を使用するためのリモート PHP CLI インタープリター。 CLI インタープリター フィールドは読み取り専用です。 |
パスマッピング | ローカルソースと、Vagrant インスタンス、Docker コンテナー、またはリモートホスト上のソース間のパスマッピング。 ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。 あるいは、フィールドの横にある |
Docker コンテナー | イメージからコンテナーを起動するために使用される Docker コンテナーの設定。 これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれる場合があります。 |
Pest ライブラリ
Pest 実行可能ファイルへのパス | pest 実行可能ファイルへの絶対パス。 |
テストランナー
デフォルト構成ファイル | デフォルトでは、PhpStorm はプロジェクトのルートフォルダー内の phpunit.xml または phpunit.xml.dist 構成ファイルを検出して使用します。 カスタム構成ファイルを使用するには、チェックボックスをオンにして、使用する構成ファイルの場所を指定します。 パスを手動で入力するか、 |