PhpStorm 2024.3 ヘルプ

テストフレームワーク

このページを使用して、現在のプロジェクトで PHP テストフレームワークを PhpStorm と統合します。PhpStorm を使用すると、PHPUnit(英語)Behat(英語)PHPSpec(英語)Codeception(英語)Pest(英語) テストを実行およびデバッグできます。

プロジェクトでテストフレームワークを設定する

  1. Add icon をクリックし、テストフレームワークとそれを実行する PHP インタープリターを選択します。

    ps_settings_php_test_frameworks.png
  2. リモートの設定では、設定済みの PHP インタープリターのいずれかを選択します:

    ps_settings_php_test_frameworks_choose_php_interpreter.png
  3. 右側のペインで、テストフレームワークをどこから取得するかを選択します。

    • Behat、PHPSpec、Codeception の場合は、フレームワークの実行可能ファイルへのパスを入力します。

    • PHPUnit の場合、使用しているフレームワークインストールのタイプを指定します。使用可能なオプションは、composer オートローダー autoload.php または phpunit.phar アーカイブです。

  4. 選択したリモート PHP インタープリターとパスのマッピングを確認してください。

  5. 必要に応じて、構成ファイルを指定します。PHPUnit では、使用するブートストラップファイルを指定することもできます。

PHPUnit

このペインでは、PHP インタープリターで使用する PHPUnit のインストールを設定します。

PHPUnit ライブラリ

この領域に、PHPUnit のインストールのタイプを指定します。使用可能なオプションは次のとおりです。

Composer オートローダーを使用する

Composer 依存関係マネージャーがインストールした PHPUnit を実行するには、このオプションを選択します。パッケージは、vendor フォルダーから autoload.php ファイルによって読み込まれ、ロードされます。スクリプトのパスフィールドに autoload.php の位置を指定します。

phpunit.phar のパス

phar アーカイブから PHPUnit を実行するには、このオプションを選択します。

  • プロジェクトにすでに phpunit.phar アーカイブがある場合は、phpunit.phar のパスフィールドにその場所を指定します。パスを手動で入力するか、the Browse button をクリックして、開いたダイアログでファイルを選択します。

  • コンピューターに phar アーカイブがまだない場合は、「Download phpunit.phar...」リンクをクリックして、PhpStorm に自動的にダウンロードさせます。

    どちらの場合でも、PhpStorm はテストの実行前にアーカイブをロードします。

テストランナー

この領域では、PhpStorm から PHPUnit テストを起動するときに使用する XML 構成ファイル(英語)へのパスを指定します。

テストを起動する前に常に PHP スクリプトが実行されるように、ブートストラップファイルへのパスを指定することもできます。

デフォルト構成ファイル

すべての PHPUnit 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される phpunit.xml または phpunit.xml.dist ファイルへのパスを指定するには、このチェックボックスを選択します。

編集時に、特定の PHPUnit 実行 / デバッグ構成の代替構成ファイルを提供できることに注意してください。

XML 構成ファイルが指定されていない場合、PhpStorm はデフォルトで‑‑ no ‑ configuration オプションを使用して PHPUnit テストを実行します。

デフォルトブートストラップファイル

テストを起動する前に常に PHP スクリプトを実行するには、このチェックボックスをオンにします。フィールドで、スクリプトの場所を指定します。パスを手動で入力するか、the Browse button をクリックして、開いたダイアログで目的のフォルダーを選択します。編集時に、特定の PHPUnit 実行 / デバッグ構成の代替ブートストラップファイルを指定することもできます。

CLI インタープリター

PHPUnit を使用するためのリモート PHP CLI インタープリター。CLI インタープリターフィールドは読み取り専用です。インタープリターダイアログで選択したインタープリターを更新するには、the Browse button をクリックします。

パスマッピング

ローカルソースと、Vagrant インスタンス内、Docker コンテナー内、またはリモートホスト上のソース間のパスマッピング。

ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。あるいは、フィールドの横にある the Browse button をクリックして、設定を手動で指定します。詳細については、リモート PHP インタープリターの構成を参照してください。

Docker コンテナー

イメージからコンテナーを開始するために使用される Docker コンテナー設定。これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれます。

PHPUnit ライブラリ

この領域に、PHPUnit のインストールのタイプを指定します。使用可能なオプションは次のとおりです。

Composer オートローダーを使用する

Composer 依存関係マネージャーがインストールした PHPUnit を実行するには、このオプションを選択します。パッケージは、vendor フォルダーから autoload.php ファイルによって読み込まれ、ロードされます。スクリプトのパスフィールドに autoload.php の位置を指定します。

phpunit.phar のパス

phar アーカイブから PHPUnit を実行するには、このオプションを選択します。

  • プロジェクトにすでに phpunit.phar アーカイブがある場合は、phpunit.phar のパスフィールドにその場所を指定します。パスを手動で入力するか、the Browse button をクリックして、開いたダイアログでファイルを選択します。

  • コンピューターに phar アーカイブがまだない場合は、「Download phpunit.phar...」リンクをクリックして、PhpStorm に自動的にダウンロードさせます。

    どちらの場合でも、PhpStorm はテストの実行前にアーカイブをロードします。

テストランナー

この領域では、シナリオの起動と実行に使用する構成 XML ファイルへのパスを設定します。

ブートストラップファイルへのパスを入力して、テストを起動する前に常に PHP スクリプトを実行することもできます。フィールドで、スクリプトの場所を指定します。パスを手動で入力するか、the Browse button をクリックして、表示されるダイアログで目的のフォルダーを選択します

デフォルト構成ファイル

すべての PHPUnit 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される phpunit.xml または phpunit.xml.dist ファイルへのパスを指定するには、このチェックボックスを選択します。

編集時に、特定の PHPUnit 実行 / デバッグ構成の代替構成ファイルを提供できることに注意してください。

XML 構成ファイルが指定されていない場合、PhpStorm はデフォルトで‑‑ no ‑ configuration オプションを使用して PHPUnit テストを実行します。

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

デフォルトブートストラップファイル

テストを起動する前に常に PHP スクリプトを実行するには、このチェックボックスをオンにします。フィールドで、スクリプトの場所を指定します。パスを手動で入力するか、the Browse button をクリックして、開いたダイアログで目的のフォルダーを選択します。編集時に、特定の PHPUnit 実行 / デバッグ構成の代替ブートストラップファイルを指定することもできます。

Behat

このペインでは、構成済みのローカルおよびリモート PHP インタープリターを介して利用可能な Behat(英語) フレームワークのインストールを設定します。

Behat ライブラリ

この領域に、使用する Behat インストールを指定します。

Behat 実行可能ファイルへのパス

このフィールドで、behat.phar アーカイブの場所、Behat 実行可能ファイルのあるフォルダーを指定します。Behat は必ずしも現在のプロジェクトルートにインストールする必要はありません。手動でパスを入力するか、the Browse button をクリックして表示されるダイアログで適切な場所を選択できます。

Behat リリース

このリンクをクリックすると、GitHub の Behat リポジトリに移動し、関連するバージョンの behat.phar アーカイブを選択できます。

Behat バージョン

この読み取り専用フィールドには、指定した Behat インストールのバージョンが表示されます。PhpStorm は、リフレッシュアイコン the Refresh button をクリックするとバージョンを検出します。デフォルト値は未インストールです。

テストランナー

この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。

デフォルト構成ファイル

すべての Behat 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。

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

CLI インタープリター

Behat を使用するためのリモート PHP CLI インタープリター。CLI インタープリターフィールドは読み取り専用です。インタープリターダイアログで選択したインタープリターを更新するには、the Browse button をクリックします。

パスマッピング

ローカルソースと、Vagrant インスタンス内、Docker コンテナー内、またはリモートホスト上のソース間のパスマッピング。

ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。あるいは、フィールドの横にある the Browse button をクリックして、設定を手動で指定します。詳細については、リモート PHP インタープリターの構成を参照してください。

Docker コンテナー

イメージからコンテナーを開始するために使用される Docker コンテナー設定。これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれます。

Behat ライブラリ

この領域に、使用する Behat インストールを指定します。

Behat 実行可能ファイルへのパス

このフィールドで、behat.phar アーカイブの場所、Behat 実行可能ファイルのあるフォルダーを指定します。Behat は必ずしも現在のプロジェクトルートにインストールする必要はありません。手動でパスを入力するか、the Browse button をクリックして表示されるダイアログで適切な場所を選択できます。

Behat リリース

このリンクをクリックすると、GitHub の Behat リポジトリに移動し、関連するバージョンの behat.phar アーカイブを選択できます。

Behat バージョン

この読み取り専用フィールドには、指定した Behat インストールのバージョンが表示されます。PhpStorm は、リフレッシュアイコン the Refresh button をクリックするとバージョンを検出します。デフォルト値は未インストールです。

テストランナー

この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。

デフォルト構成ファイル

すべての Behat 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。

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

PHPSpec

このペインでは、構成済みのローカルおよびリモート PHP インタープリターを介して利用可能な PHPSpec(英語) ツールセットのインストールを設定します。

PHPSpec ライブラリ

この領域に、使用する PHPSpec のインストールを指定します。

PHPSpec 実行ファイルへのパス

このフィールドに、phpspec の場所を指定します。PHPSpec は必ずしも現在のプロジェクトルートにインストールする必要はありません。

ローカルインタープリターに PHPSpec へのパスが指定されていない場合、PhpStorm は PHPSpec の完全なサポートを提供しません。たとえば、コード補完の提案を表示せず、参照を解決しません。

接頭辞 ('spec_prefix' )

この読み取り専用フィールドには、仕様の名前空間接頭辞が表示されます。PhpStorm は、デフォルト構成ファイルフィールドで指定された構成ファイルから spec_prefix を検出します。デフォルト値は spec です。詳細については、「PHPSpec の設定: PSR-4(英語) および PHPSpec の設定: スペックとソースの場所(英語)」を参照してください。

テストランナー

この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。

デフォルト構成ファイル

すべての PHPSpec 実行 / デバッグ構成でデフォルトの構成ファイルとして使用される YML ファイルへのパスを指定するには、このチェックボックスを選択します。

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

CLI インタープリター

PHPSpec を使用するためのリモート PHP CLI インタープリター。CLI インタープリターフィールドは読み取り専用です。the Browse button をクリックすると、インタープリターダイアログで選択したインタープリターが更新されます。

パスマッピング

ローカルソースと、Vagrant インスタンス内、Docker コンテナー内、またはリモートホスト上のソース間のパスマッピング。

ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。あるいは、フィールドの横にある the Browse button をクリックして、設定を手動で指定します。詳細については、リモート PHP インタープリターの構成を参照してください。

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 インストールのバージョンを表示します。the Refresh button をクリックすると、PhpStorm がバージョンを検出します。デフォルト値は未インストールです。

テストランナー

この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。

デフォルト構成ファイル

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

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

CLI インタープリター

Codeception を使用するためのリモート PHP CLI インタープリター。CLI インタープリターフィールドは読み取り専用です。インタープリターダイアログで選択したインタープリターを更新するには、the Browse button をクリックします。

パスマッピング

ローカルソースと、Vagrant インスタンス内、Docker コンテナー内、またはリモートホスト上のソース間のパスマッピング。

ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。あるいは、フィールドの横にある the Browse button をクリックして、設定を手動で指定します。詳細については、リモート PHP インタープリターの構成を参照してください。

Docker コンテナー

イメージからコンテナーを開始するために使用される Docker コンテナー設定。これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれます。

Codeception ライブラリ

この領域に、使用する Codeception インストールを指定します。

Codeception 実行可能ファイルへのパス

このフィールドで、codeception.phar アーカイブの場所、Codeception 実行可能ファイルのあるフォルダーを指定します。

Codeception リリース

このリンクをクリックすると、GitHub の Codeception リポジトリに移動し、関連するバージョンの codeception.phar アーカイブを選択できます。

Codeception バージョン

この読み取り専用フィールドは、指定された Codeception インストールのバージョンを表示します。the Refresh button をクリックすると、PhpStorm がバージョンを検出します。デフォルト値は未インストールです。

テストランナー

この領域では、シナリオの起動と実行に使用する構成 YML ファイルへのパスを設定します。

デフォルト構成ファイル

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

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

Pest

このペインでは、構成されたローカルおよびリモート PHP インタープリターを通じて利用可能な Pest(英語) テストフレームワークのインストールを構成します。

Pest ライブラリ

Pest 実行可能ファイルへのパス

pest 実行可能ファイルへの絶対パス。the Browse button をクリックし、開いたダイアログで関連する場所を選択します。

Composer を使用してプロジェクトに Pest 依存関係をインストールすると、PhpStorm はインストールされた Pest 実行可能ファイルを自動的に検出します。

テストランナー

デフォルト構成ファイル

デフォルトでは、PhpStorm はプロジェクトルートフォルダー内の phpunit.xml または phpunit.xml.dist 構成ファイルを検出して使用します。

カスタム構成ファイルを使用するには、チェックボックスをオンにして、使用する構成ファイルの場所を指定します。パスを手動で入力するか、the Browse button をクリックして、表示されるダイアログで適切な場所を選択します。

CLI インタープリター

Pest を使用するためのリモート PHP CLI インタープリター。CLI インタープリターフィールドは読み取り専用です。インタープリターダイアログで選択したインタープリターを更新するには、the Browse button をクリックします。

パスマッピング

ローカルソースと、Vagrant インスタンス内、Docker コンテナー内、またはリモートホスト上のソース間のパスマッピング。

ほとんどの場合、PhpStorm はパスマッピングとコンテナー設定を検出し、すべてのフィールドに自動的に入力します。あるいは、フィールドの横にある the Browse button をクリックして、設定を手動で指定します。詳細については、リモート PHP インタープリターの構成を参照してください。

Docker コンテナー

イメージからコンテナーを開始するために使用される Docker コンテナー設定。これらの設定には、ボリューム構成、公開ポート、ネットワークなどが含まれます。

Pest ライブラリ

Pest 実行可能ファイルへのパス

pest 実行可能ファイルへの絶対パス。the Browse button をクリックし、開いたダイアログで関連する場所を選択します。

テストランナー

デフォルト構成ファイル

デフォルトでは、PhpStorm はプロジェクトルートフォルダー内の phpunit.xml または phpunit.xml.dist 構成ファイルを検出して使用します。

カスタム構成ファイルを使用するには、チェックボックスをオンにして、使用する構成ファイルの場所を指定します。パスを手動で入力するか、the Browse button をクリックして、表示されるダイアログで適切な場所を選択します。

関連ページ:

Composer 依存関係マネージャー

PhpStorm は Composer 依存関係マネージャーと統合されています。これにより、Packagist またはカスタムリポジトリからのパッケージをプロジェクトの依存関係として宣言し、IDE から管理できます。PhpStorm は以下を提供します。一般的な Composer コマンド (init、install、update) と、その他の Composer コマンドを実行するための専用ユーザーインターフェース。コマンド出力は Composer ログコンソールに表示されます。PhpStorm プロ...

PHPUnit

このダイアログを使用して、PHPUnit フレームワークを使用してコンソールで PHP アプリケーションの単体テストを実行およびデバッグするために使用する構成を作成します。始める前に:PHPUnit サポートを有効にする PHPUnit をコンピューターにインストールして構成します。PHPUnit を参照してください。PHP プラグインが有効になっていることを確認してください。PHP プラグインは PhpStorm にバンドルされており、デフォルトで有効になります。プラグインが無効になっている場合は、プラ...

リモート PHP インタープリターの構成

リモート PHP インタープリターは、リモートホストまたは仮想環境にインストールされる PHP エンジンです。リモート PHP インタープリターという用語は、ローカルコンピューターにインストールされるローカル PHP インタープリターの反対です。PhpStorm では、Docker コンテナー内、Docker Compose、Vagrant、WSL 経由で、SSH 経由でリモート PHP インタープリターへのアクセスを構成できます。SSH 構成タイプを使用すると、リモートホスト上のサーバーにインスト...