Running Symfony Tests

The Symfony project uses a third-party service which automatically runs tests for any submitted patch. If the new code breaks any test, the pull request will show an error message with a link to the full error details.

Symfony プロジェクトは、提出されたパッチのテストを自動的に実行するサードパーティ サービスを使用します。新しいコードがいずれかのテストに違反した場合、プル リクエストは、エラーの詳細へのリンクを含むエラー メッセージを表示します。

In any case, it's a good practice to run tests locally before submitting a patch for inclusion, to check that you have not broken anything.

いずれにせよ、パッチを含める前にローカルでテストを実行して、何も壊れていないことを確認することをお勧めします。

Before Running the Tests

To run the Symfony test suite, install the external dependencies used during the tests, such as Doctrine, Twig and Monolog. To do so, install Composer and execute the following:

Symfony テスト スイートを実行するには、Doctrine、Twig、Monolog など、テスト中に使用される外部依存関係をインストールします。これを行うには、Composer をインストールし、次を実行します。
1
$ composer update

Tip

ヒント

Dependencies might fail to update and in this case Composer might need you to tell it what Symfony version you are working on. To do so set COMPOSER_ROOT_VERSION variable, e.g.:

依存関係の更新に失敗する可能性があり、この場合、Composer は作業中の Symfony のバージョンを通知する必要がある場合があります。そのためには、COMPOSER_ROOT_VERSION 変数を設定します。
1
$ COMPOSER_ROOT_VERSION=4.4.x-dev composer update

Running the Tests

Then, run the test suite from the Symfony root directory with the following command:

次に、次のコマンドを使用して、Symfony ルート ディレクトリからテスト スイートを実行します。
1
$ php ./phpunit symfony

The output should display OK. If not, read the reported errors to figure out what's going on and if the tests are broken because of the new code.

出力に OK が表示されるはずです。そうでない場合は、報告されたエラーを読んで、何が起こっているのか、新しいコードが原因でテストが壊れていないかを確認してください。

Tip

ヒント

The entire Symfony suite can take up to several minutes to complete. If you want to test a single component, type its path after the phpunit command, e.g.:

Symfony スイート全体が完了するまでに数分かかる場合があります。単一のコンポーネントをテストする場合は、phpunit コマンドの後にそのパスを入力します。
1
$ php ./phpunit src/Symfony/Component/Finder/

Tip

ヒント

On Windows, install the Cmder, ConEmu, ANSICON or Mintty free applications to see colored test results.

Windows では、Cmder、ConEmu、ANSICON、または Mintty の無料アプリケーションをインストールして、色付きのテスト結果を表示します。