イントロダクション
Laravelはユニットテストも考慮して構築されています。実際、PHPUnitをサポートしており、最初から含まれています。アプリケーションのためにphpunit.xmlファイルも最初から準備されています。さらにフレームワークはアプリケーションを記述的にテストするために便利なヘルパメソッドも持っています。
デフォルトでアプリケーションのtestsディレクトリには、２つのディレクトリが存在しています。Feature
とUnitです。ユニットテストは極小さい、コードの独立した一部をテストします。実際、ほとんどのユニット(Unit)テストは一つのメソッドに焦点をあてます。機能(Feature)テストは、多くのオブジェクトがそれぞれどのように関しているかとか、JSONエンドポイントへ完全なHTTPリクエストを送ることさえ含む、コードの幅広い範囲をテストします。
FeatureとUnit、両テストディレクトリには、ExampleTest.phpが用意されています。真新しいLaravelアプリケーションをインストールしたらテストを実行するため、コマンドラインからvendor/bin/phpunitを実行してください。
環境
phpunit.xmlファイル中で環境変数が設定されているため、vendor/bin/phpunitを実行するとLaravelは自動的に設定環境をtestingにセットします。Laravelはまた、セッションとキャッシュの設定をarrayドライバーに設定し、テスト中のセッションやキャッシュデータが残らないようにします。
必要であれば他のテスト設定環境を自由に作成することもできます。testing動作環境変数はphpunit.xmlの中で設定されています。テスト実行前には、config:clear
Artisanコマンドを実行し、設定キャッシュをクリアするのを忘れないでください。
さらに、プロジェクトのルートディレクトリで、.env.testingファイルを生成することも可能です。PHPUnitテストやArtisanコマンドを--env=testingオプション付きで実行する場合、.envファイルをこのファイルの内容でオーバーライドします。
テストの生成と実行
新しいテストケースを作成するには、make:test
Artisanコマンドを使います。
// Featureディレクトリにテストを生成する
php artisan make:test UserTest
// Unitディレクトリにテストを生成する
php artisan make:test UserTest --unitTip!! stubのリソース公開 を使って、Testスタブをカスタマイズできます。
テストを生成したら、PHPUnitを使用するときと同じようにテストメソッドを定義してください。テストを実行するには、ターミナルでphpunitかartisan testコマンドを実行します。
<?php
namespace Tests\Unit;
use PHPUnit\Framework\TestCase;
class ExampleTest extends TestCase
{
/**
* 基本的なテスト例
*
* @return void
*/
public function testBasicTest()
{
$this->assertTrue(true);
}
}Note: テストクラスに独自の
setUpメソッドを定義する場合は、親のクラスのparent::setUp()／parent::tearDown()を確実に呼び出してください。
Artisanテストランナー
テスト実行にはphpunitコマンドに加え、test
Artisanコマンドも使用できます。Artisanテストランナーは現在実行中のテストに関するより詳しい情報を提供し、テストに失敗した最初の時点で自動的に停止します。
php artisan testphpunitコマンドで使用できる引数はすべてArtisan
testコマンドにも渡せます。
php artisan test --group=feature