【Laravel】テストを実行するartisan testコマンドを解説します

こんにちは。たいら(@tairaengineer2)です。
転職を繰り返し現在5社経験している、12年目エンジニアです。

この記事では、 Laravelでテストを実行するartisan testコマンドについて解説していきます。

前提：実行環境
テストを実行するコマンドを解説
まとめ：テストを実行してみよう

前提：実行環境

実行環境は以下の通りです。

OS	Windows11
PHPのバージョン	8.2.4
Laravelのバージョン	10.45.1

この記事では

C:\Laravel

配下に【LaravelSample】という名前でプロジェクトを作成しています。
Laravelの機能テストクラスを新規作成するartisan make:testコマンドを解説

テストを実行するコマンドを解説

テストを実行するコマンドを解説します。

コマンドプロンプトを開きLaravelプロジェクトをまで移動させます。

コマンドプロンプトを開き、cdコマンドで移動
エクスプローラーからコマンドプロンプトを起動

のどちらかで移動させてください。
エクスプローラーからコマンドプロンプトを起動するやり方は、下記の記事をご参考ください。

【Windows11】エクスプローラーからコマンドプロンプトを起動する方法を解説します

この記事では

C:\Laravel

配下に【LaravelSample】という名前でプロジェクトを作成しているので、プロジェクトのディレクトリまで移動します。
Laravelのテストを実行するartisan testコマンドを解説

テスト実行するためのコマンドは、

php artisan test

1	php artisan test

です。
このコマンドを実行すると

プロジェクト\tests

配下のテストはすべて実行されます。

テストクラスを作成していなくても大丈夫です。
Laravelプロジェクトを新規作成したとき、サンプルテストクラスも作成されているからです。
そのサンプルテストクラスは

・機能テストクラス
プロジェクト\tests\Feature\ExampleTest.php
・単体テストクラス
プロジェクト\tests\Unit\ExampleTest.php

の2つあります。
中身はそれぞれ以下のようになっています。
\tests\Feature\ExampleTest.php

<?php

namespace Tests\Feature;

// use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic test example.
     */
    public function test_the_application_returns_a_successful_response(): void
    {
        $response = $this->get('/');

        $response->assertStatus(200);
    }
}

<?php

namespace Tests\Feature;

// use Illuminate\Foundation\Testing\RefreshDatabase;

use Tests\TestCase;

class ExampleTest extends TestCase

{

/**

* A basic test example.

public function test_the_application_returns_a_successful_response(): void

{

$response = $this->get('/');

$response->assertStatus(200);

}

\tests\Unit\ExampleTest.php

<?php

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic test example.
     */
    public function test_that_true_is_true(): void
    {
        $this->assertTrue(true);
    }
}

<?php

namespace Tests\Unit;

use PHPUnit\Framework\TestCase;

class ExampleTest extends TestCase

{

/**

* A basic test example.

public function test_that_true_is_true(): void

{

$this->assertTrue(true);

}

ではコマンドをたたきます。

php artisan test

1	php artisan test

Laravelのテストを実行するartisan testコマンドを解説

   PASS  Tests\Unit\ExampleTest
  ✓ that true is true                                                                                            0.15s

   PASS  Tests\Feature\ExampleTest
  ✓ the application returns a successful response                                                                1.17s

  Tests:    2 passed (2 assertions)
  Duration: 2.56s

PASS Tests\Unit\ExampleTest

✓ that true is true 0.15s

PASS Tests\Feature\ExampleTest

✓ the application returns a successful response 1.17s

Tests: 2 passed (2 assertions)

Duration: 2.56s

テストを実行することができました。
「PASS」と表示されていれば、そのテストは通過している、という意味になります。

まとめ：テストを実行してみよう

以上がLaravelでテストを実行するartisan testコマンドの解説でした！

このコマンドはオプションをつけることができます。
詳細な解説はこちらの記事をご参考ください。

【Laravel】PHPUnitテスト実行結果をhtml形式で出力するtestdox-htmlオプションを解説します

あなたのご参考になったのなら、とても嬉しいです(*´▽｀*)
ではでは～(・ω・)ﾉｼ