본문으로 건너뛰기
버전: 8.x

HTTP 테스트 (HTTP Tests)

소개​

라라벨은 애플리케이션으로 HTTP 요청을 보낸 뒤, 그 응답을 손쉽게 검사할 수 있는 유연한 API를 제공합니다. 예를 들어, 아래에 정의된 기능 테스트(feature test)를 살펴보세요.

<?php

namespace Tests\Feature;

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

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

        $response->assertStatus(200);
    }
}

위 코드에서 get 메서드는 애플리케이션에 GET 요청을 보내고, assertStatus 메서드는 해당 응답의 HTTP 상태 코드가 지정한 값과 일치하는지 확인합니다. 이와 같은 간단한 assert 외에도, 라라벨은 응답 헤더, 본문 내용, JSON 구조 등 다양한 요소를 확인할 수 있는 여러 assert 메서드를 제공합니다.

요청 보내기​

애플리케이션에 요청을 보내기 위해, 테스트 내에서 get, post, put, patch, delete 메서드 중 하나를 사용할 수 있습니다. 이 메서드들은 실제로 네트워크를 통해 "진짜" HTTP 요청을 보내는 것이 아니라, 내부적으로 네트워크 요청을 시뮬레이션합니다.

테스트 요청 메서드는 Illuminate\Http\Response 인스턴스를 반환하는 대신, 다양한 유용한 assert 메서드를 제공하는 Illuminate\Testing\TestResponse 인스턴스를 반환합니다. 이를 통해 애플리케이션의 응답을 쉽게 검사할 수 있습니다.

<?php

namespace Tests\Feature;

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

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

        $response->assertStatus(200);
    }
}

일반적으로, 각 테스트는 애플리케이션에 단 한 번만 요청을 보내는 것이 좋습니다. 하나의 테스트 메서드 내에서 여러 번 요청을 보낼 경우, 예기치 않은 동작이 발생할 수 있습니다.

[!TIP] 편의를 위해, 테스트를 실행할 때 CSRF 미들웨어가 자동으로 비활성화됩니다.

요청 헤더 커스터마이즈​

요청을 보내기 전에 withHeaders 메서드를 사용해 요청 헤더를 원하는 대로 커스터마이즈할 수 있습니다. 이 메서드를 통해 요청에 원하는 헤더를 추가할 수 있습니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic functional test example.
     *
     * @return void
     */
    public function test_interacting_with_headers()
    {
        $response = $this->withHeaders([
            'X-Header' => 'Value',
        ])->post('/user', ['name' => 'Sally']);

        $response->assertStatus(201);
    }
}

쿠키​

withCookie 또는 withCookies 메서드를 통해 요청에 쿠키 값을 세팅할 수 있습니다. withCookie는 쿠키 이름과 값을 각각 인수로 받고, withCookies는 여러 개의 이름/값 쌍을 배열로 받을 수 있습니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_interacting_with_cookies()
    {
        $response = $this->withCookie('color', 'blue')->get('/');

        $response = $this->withCookies([
            'color' => 'blue',
            'name' => 'Taylor',
        ])->get('/');
    }
}

세션 / 인증​

라라벨은 HTTP 테스트 중 세션과 상호작용할 수 있도록 다양한 헬퍼를 제공합니다. 먼저, withSession 메서드로 세션에 원하는 데이터를 미리 세팅할 수 있습니다. 이 기능을 통해 요청을 보내기 전에 세션에 값을 저장해 둘 수 있습니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_interacting_with_the_session()
    {
        $response = $this->withSession(['banned' => false])->get('/');
    }
}

라라벨의 세션은 일반적으로 현재 인증된 사용자의 상태를 저장하는 데 사용됩니다. 이를 위해 actingAs 헬퍼 메서드를 이용하면, 특정 사용자를 현재 사용자로 인증할 수 있습니다. 예를 들어, 모델 팩토리를 이용해 사용자를 생성하고 인증할 수 있습니다.

<?php

namespace Tests\Feature;

use App\Models\User;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_an_action_that_requires_authentication()
    {
        $user = User::factory()->create();

        $response = $this->actingAs($user)
                         ->withSession(['banned' => false])
                         ->get('/');
    }
}

또한, actingAs 메서드의 두 번째 인수로 가드(guard) 이름을 지정해 어떤 가드를 사용할지 선택할 수 있습니다.

$this->actingAs($user, 'web')

응답 디버깅​

테스트 요청을 보낸 후, dump, dumpHeaders, dumpSession 메서드를 이용해 응답의 내용을 직접 확인하고 디버깅할 수 있습니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

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

        $response->dumpHeaders();

        $response->dumpSession();

        $response->dump();
    }
}

또는, dd, ddHeaders, ddSession 메서드를 사용하면 응답 정보를 출력하고 테스트 실행이 즉시 중단됩니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

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

        $response->ddHeaders();

        $response->ddSession();

        $response->dd();
    }
}

예외 처리​

특정 예외가 실제로 발생하는지 테스트하고 싶을 때가 있습니다. 이때, 라라벨의 예외 핸들러가 해당 예외를 받아 HTTP 응답으로 반환하지 않도록, 요청 전에 withoutExceptionHandling 메서드를 호출할 수 있습니다.

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

또한, 애플리케이션이 PHP나 의존 라이브러리에서 더 이상 권장되지 않는(deprecated) 기능을 사용하고 있는지 확인하고 싶다면, 요청 전에 withoutDeprecationHandling 메서드를 사용할 수 있습니다. 이 기능이 비활성화되어 있으면, deprecated 경고가 예외로 변환되어 테스트가 실패합니다.

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

JSON API 테스트​

라라벨은 JSON API와 그 응답을 테스트하기 위한 여러 도우미 메서드도 제공합니다. 예를 들어, json, getJson, postJson, putJson, patchJson, deleteJson, optionsJson 메서드를 사용해 다양한 HTTP 메서드로 JSON 요청을 보낼 수 있습니다. 이 메서드들을 사용할 때 데이터와 헤더도 간편하게 전달할 수 있습니다. 다음은 /api/user 엔드포인트로 POST 요청을 보내고, 예상한 JSON 데이터가 반환되었는지 검증하는 테스트 예시입니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic functional test example.
     *
     * @return void
     */
    public function test_making_an_api_request()
    {
        $response = $this->postJson('/api/user', ['name' => 'Sally']);

        $response
            ->assertStatus(201)
            ->assertJson([
                'created' => true,
            ]);
    }
}

또한, JSON 응답 데이터는 배열 변수처럼 $response['created'] 형태로 접근할 수 있어, 응답으로 전달된 각 값들을 쉽게 검사할 수 있습니다.

$this->assertTrue($response['created']);

[!TIP] assertJson 메서드는 응답을 배열로 변환한 뒤, PHPUnit::assertArraySubset을 사용해 해당 배열이 실제 응답 JSON에서 존재하는지 검사합니다. 즉, JSON 응답에 다른 속성이 추가로 있어도, 지정한 조각(fragment)이 포함되어 있으면 이 테스트는 통과합니다.

JSON 값 일치 여부 assert​

앞서 설명한 것처럼, assertJson 메서드는 JSON 응답 내에 특정 조각(fragment)이 존재하는지 검사합니다. 만약 기대하는 배열이 응답 JSON과 정확히 일치하는지 검증하려면 assertExactJson 메서드를 사용해야 합니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic functional test example.
     *
     * @return void
     */
    public function test_asserting_an_exact_json_match()
    {
        $response = $this->postJson('/user', ['name' => 'Sally']);

        $response
            ->assertStatus(201)
            ->assertExactJson([
                'created' => true,
            ]);
    }
}

JSON 경로 값 assert​

JSON 응답의 특정 경로에 데이터가 존재하는지 검사하고 싶다면, assertJsonPath 메서드를 사용하면 됩니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    /**
     * A basic functional test example.
     *
     * @return void
     */
    public function test_asserting_a_json_paths_value()
    {
        $response = $this->postJson('/user', ['name' => 'Sally']);

        $response
            ->assertStatus(201)
            ->assertJsonPath('team.owner.name', 'Darian');
    }
}

유연한 JSON 테스트​

라라벨은 애플리케이션의 JSON 응답을 더욱 직관적으로 검증할 수 있는 플루언트(fluent) 방식의 테스트 API도 제공합니다. 먼저, assertJson 메서드에 클로저를 전달하면, 이 클로저에서는 Illuminate\Testing\Fluent\AssertableJson 인스턴스를 받아 응답 JSON에 대해 다양한 검증을 진행할 수 있습니다. 예를 들어, where 메서드로 특정 속성을 검사하고, missing 메서드로 특정 속성이 없는지 확인할 수 있습니다.

use Illuminate\Testing\Fluent\AssertableJson;

/**
 * A basic functional test example.
 *
 * @return void
 */
public function test_fluent_json()
{
    $response = $this->getJson('/users/1');

    $response
        ->assertJson(fn (AssertableJson $json) =>
            $json->where('id', 1)
                 ->where('name', 'Victoria Faith')
                 ->missing('password')
                 ->etc()
        );
}

etc 메서드 이해하기​

위 예시의 마지막 부분에서 etc 메서드가 사용된 점을 볼 수 있습니다. 이 메서드는 해당 JSON 객체에 추가 속성이 더 있을 수 있음을 라라벨에 알려줍니다. 만약 etc를 사용하지 않으면, 명시적으로 assert로 검사하지 않은 다른 속성이 JSON 객체에 있을 경우 테스트가 실패합니다.

이 방식은, 민감한 정보를 JSON 응답에 실수로 노출하는 것을 방지하도록 설계되었습니다. 즉, assert를 통해 명시적으로 속성을 검사하거나, etc 메서드를 통해 추가 속성을 허용해야만 합니다.

속성 존재/부재 여부 assert​

특정 속성이 존재하는지 또는 없는지를 assert하고자 할 때, has와 missing 메서드를 사용할 수 있습니다.

$response->assertJson(fn (AssertableJson $json) =>
    $json->has('data')
         ->missing('message')
);

또한, 여러 개의 속성에 대해 존재/부재 여부를 한 번에 검사하고 싶을 때는 hasAll과 missingAll 메서드를 사용할 수 있습니다.

$response->assertJson(fn (AssertableJson $json) =>
    $json->hasAll('status', 'data')
         ->missingAll('message', 'code')
);

주어진 속성 리스트 중 하나 이상만 존재하는지 확인하고 싶다면, hasAny 메서드를 사용할 수 있습니다.

$response->assertJson(fn (AssertableJson $json) =>
    $json->has('status')
         ->hasAny('data', 'message', 'code')
);

JSON 컬렉션 검사​

여러 개의 항목(예: 여러 사용자)을 담고 있는 JSON 응답을 반환하는 경우도 많습니다.

Route::get('/users', function () {
    return User::all();
});

이런 경우, 플루언트 JSON의 has 메서드를 사용해 응답에 포함된 사용자 수를 검증할 수 있습니다. 예를 들어, JSON 응답에 3명의 사용자가 포함되어 있는지 확인하고, 컬렉션의 첫 번째 사용자에 대해 추가 검증을 이어갈 수도 있습니다. first 메서드는 클로저를 받아, JSON 컬렉션의 첫 번째 객체를 플루언트하게 검사할 수 있게 합니다.

$response
    ->assertJson(fn (AssertableJson $json) =>
        $json->has(3)
             ->first(fn ($json) =>
                $json->where('id', 1)
                     ->where('name', 'Victoria Faith')
                     ->missing('password')
                     ->etc()
             )
    );

JSON 컬렉션 스코핑​

애플리케이션의 라우트가 'users', 'meta' 등 네임드 키로 JSON 컬렉션을 반환하는 경우도 있습니다.

Route::get('/users', function () {
    return [
        'meta' => [...],
        'users' => User::all(),
    ];
})

이러한 경우, has 메서드를 사용해 컬렉션 항목 개수를 검사할 수 있습니다. 또, has 메서드를 연결(chain)해 다양한 assert를 이어갈 수도 있습니다.

$response
    ->assertJson(fn (AssertableJson $json) =>
        $json->has('meta')
             ->has('users', 3)
             ->has('users.0', fn ($json) =>
                $json->where('id', 1)
                     ->where('name', 'Victoria Faith')
                     ->missing('password')
                     ->etc()
             )
    );

하지만, users 컬렉션에 대한 assert를 별도의 두 번의 has 호출 대신, 한 번의 has 호출에서 클로저를 세 번째 인자로 전달하는 방법도 있습니다. 이렇게 하면 해당 클로저가 자동으로 컬렉션의 첫 번째 항목으로 스코핑되어 실행됩니다.

$response
    ->assertJson(fn (AssertableJson $json) =>
        $json->has('meta')
             ->has('users', 3, fn ($json) =>
                $json->where('id', 1)
                     ->where('name', 'Victoria Faith')
                     ->missing('password')
                     ->etc()
             )
    );

JSON 타입 assert​

응답 JSON의 속성 타입이 특정 타입인지 검사하고 싶다면, Illuminate\Testing\Fluent\AssertableJson 클래스의 whereType 및 whereAllType 메서드를 사용할 수 있습니다.

$response->assertJson(fn (AssertableJson $json) =>
    $json->whereType('id', 'integer')
         ->whereAllType([
            'users.0.name' => 'string',
            'meta' => 'array'
        ])
);

| 문자로 타입 여러 개를 지정하거나, whereType의 두 번째 인자로 타입 배열을 전달할 수도 있습니다. 응답 값이 지정한 타입 중 하나와 일치하면 assert는 성공합니다.

$response->assertJson(fn (AssertableJson $json) =>
    $json->whereType('name', 'string|null')
         ->whereType('id', ['string', 'integer'])
);

whereType과 whereAllType 메서드는 다음 타입을 인식합니다: string, integer, double, boolean, array, null.

파일 업로드 테스트​

Illuminate\Http\UploadedFile 클래스는 테스트용 더미 파일 또는 이미지를 생성할 수 있는 fake 메서드를 제공합니다. 여기에 Storage 파사드의 fake 메서드를 조합하면 파일 업로드 테스트를 매우 간편하게 만들 수 있습니다. 예를 들어, 두 기능을 결합해 아바타 업로드 폼의 테스트를 손쉽게 작성할 수 있습니다.

<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Http\UploadedFile;
use Illuminate\Support\Facades\Storage;
use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_avatars_can_be_uploaded()
    {
        Storage::fake('avatars');

        $file = UploadedFile::fake()->image('avatar.jpg');

        $response = $this->post('/avatar', [
            'avatar' => $file,
        ]);

        Storage::disk('avatars')->assertExists($file->hashName());
    }
}

특정 파일이 존재하지 않는지 테스트해야 한다면, Storage 파사드의 assertMissing 메서드를 사용할 수 있습니다.

Storage::fake('avatars');

// ...

Storage::disk('avatars')->assertMissing('missing.jpg');

파일 생성 테스트 커스터마이즈​

UploadedFile 클래스에서 제공하는 fake 메서드를 사용해 파일을 생성할 때, 이미지의 가로(width), 세로(height) 크기와 용량(킬로바이트 단위)을 지정하여 애플리케이션의 유효성 검증 규칙을 더 정밀하게 테스트할 수 있습니다.

UploadedFile::fake()->image('avatar.jpg', $width, $height)->size(100);

이미지 생성뿐만 아니라, create 메서드를 사용하면 다른 모든 타입의 파일도 생성할 수 있습니다.

UploadedFile::fake()->create('document.pdf', $sizeInKilobytes);

필요하다면, 파일의 MIME 타입을 명확히 지정하고 싶을 때 $mimeType 인수를 메서드에 전달할 수 있습니다.

UploadedFile::fake()->create(
    'document.pdf', $sizeInKilobytes, 'application/pdf'
);

뷰(View) 테스트하기​

라라벨에서는 애플리케이션에 대한 모의 HTTP 요청 없이도 뷰를 렌더링해볼 수 있습니다. 이를 위해 테스트 내에서 view 메서드를 호출하면 됩니다. view 메서드는 뷰의 이름과, 옵션으로 뷰에 전달할 데이터를 배열로 받을 수 있습니다. 이 메서드는 Illuminate\Testing\TestView 인스턴스를 반환하며, 뷰의 내용에 대해 다양한 assert(검증) 메서드를 제공합니다.

<?php

namespace Tests\Feature;

use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_a_welcome_view_can_be_rendered()
    {
        $view = $this->view('welcome', ['name' => 'Taylor']);

        $view->assertSee('Taylor');
    }
}

TestView 클래스에서는 다음과 같은 assert 메서드를 제공하고 있습니다: assertSee, assertSeeInOrder, assertSeeText, assertSeeTextInOrder, assertDontSee, assertDontSeeText.

필요하다면, TestView 인스턴스를 문자열로 변환하여 뷰의 최종 렌더링 결과(문자열)를 직접 얻을 수 있습니다.

$contents = (string) $this->view('welcome');

에러 메시지 공유​

뷰에 따라 라라벨에서 제공하는 전역 에러 백에 공유된 에러 메시지를 기반으로 동작하는 경우가 있습니다. 테스트에서 에러 백을 에러 메시지로 채워주기 위해서는 withViewErrors 메서드를 사용할 수 있습니다.

$view = $this->withViewErrors([
    'name' => ['Please provide a valid name.']
])->view('form');

$view->assertSee('Please provide a valid name.');

Blade 및 컴포넌트 렌더링​

필요하다면, blade 메서드를 활용하여 원시 Blade 문자열을 직접 평가하고 렌더링할 수 있습니다. view 메서드와 마찬가지로 blade 메서드도 Illuminate\Testing\TestView 인스턴스를 반환합니다.

$view = $this->blade(
    '<x-component :name="$name" />',
    ['name' => 'Taylor']
);

$view->assertSee('Taylor');

또한, component 메서드를 사용하면 Blade 컴포넌트를 평가하고 렌더링할 수 있습니다. view와 마찬가지로, 이 메서드 또한 Illuminate\Testing\TestView 인스턴스를 반환합니다.

$view = $this->component(Profile::class, ['name' => 'Taylor']);

$view->assertSee('Taylor');

사용 가능한 어서션(Assertion)​

응답(Response) 어서션​

라라벨의 Illuminate\Testing\TestResponse 클래스는 애플리케이션 테스트 시 다양한 맞춤형 어서션 메서드를 제공합니다. 이 어서션들은 json, get, post, put, delete 등의 테스트 메서드가 반환하는 응답에서 사용할 수 있습니다.

assertCookie assertCookieExpired assertCookieNotExpired assertCookieMissing assertCreated assertDontSee assertDontSeeText assertDownload assertExactJson assertForbidden assertHeader assertHeaderMissing assertJson assertJsonCount assertJsonFragment assertJsonMissing assertJsonMissingExact assertJsonMissingValidationErrors assertJsonPath assertJsonStructure assertJsonValidationErrors assertJsonValidationErrorFor assertLocation assertNoContent assertNotFound assertOk assertPlainCookie assertRedirect assertRedirectContains assertRedirectToSignedRoute assertSee assertSeeInOrder assertSeeText assertSeeTextInOrder assertSessionHas assertSessionHasInput assertSessionHasAll assertSessionHasErrors assertSessionHasErrorsIn assertSessionHasNoErrors assertSessionDoesntHaveErrors assertSessionMissing assertSimilarJson assertStatus assertSuccessful assertUnauthorized assertUnprocessable assertValid assertInvalid assertViewHas assertViewHasAll assertViewIs assertViewMissing

assertCookie​

응답에 지정한 쿠키가 포함되어 있는지 확인합니다.

$response->assertCookie($cookieName, $value = null);

assertCookieExpired​

응답에 지정한 쿠키가 포함되어 있고, 만료되었는지 확인합니다.

$response->assertCookieExpired($cookieName);

assertCookieNotExpired​

응답에 지정한 쿠키가 포함되어 있고, 아직 만료되지 않았는지 확인합니다.

$response->assertCookieNotExpired($cookieName);

assertCookieMissing​

응답에 지정한 쿠키가 포함되어 있지 않은지 확인합니다.

$response->assertCookieMissing($cookieName);

assertCreated​

응답이 201 HTTP 상태 코드를 가지고 있는지 확인합니다.

$response->assertCreated();

assertDontSee​

애플리케이션에서 반환된 응답에 지정한 문자열이 포함되어 있지 않은지 검증합니다. 두 번째 매개변수에 false를 전달하지 않는 한, 이 어서션은 자동으로 문자열을 이스케이프 처리합니다.

$response->assertDontSee($value, $escaped = true);

assertDontSeeText​

응답 텍스트에 지정한 문자열이 포함되어 있지 않은지 검증합니다. 두 번째 매개변수에 false를 전달하지 않는 한, 지정한 문자열은 자동으로 이스케이프 처리됩니다. 이 메서드는 검증 전에 응답 내용을 strip_tags PHP 함수에 전달합니다.

$response->assertDontSeeText($value, $escaped = true);

assertDownload​

응답이 "다운로드"인지(즉, 해당 라우트가 Response::download 응답이나 BinaryFileResponse, Storage::download 응답을 반환했는지) 검증합니다.

$response->assertDownload();

원한다면, 다운로드 파일에 지정한 파일명이 할당되어 있는지도 검증할 수 있습니다.

$response->assertDownload('image.jpg');

assertExactJson​

응답이 지정한 JSON 데이터를 정확히 포함하고 있는지 확인합니다.

$response->assertExactJson(array $data);

assertForbidden​

응답이 금지된 요청(403) HTTP 상태 코드를 갖는지 확인합니다.

$response->assertForbidden();

assertHeader​

응답에 지정한 헤더 및 값이 포함되어 있는지 확인합니다.

$response->assertHeader($headerName, $value = null);

assertHeaderMissing​

응답에 지정한 헤더가 포함되어 있지 않은지 확인합니다.

$response->assertHeaderMissing($headerName);

assertJson​

응답에 지정한 JSON 데이터가 포함되어 있는지 확인합니다.

$response->assertJson(array $data, $strict = false);

assertJson 메서드는 응답을 배열로 변환한 후, PHPUnit::assertArraySubset을 이용해서 지정한 배열이 애플리케이션에서 반환된 JSON 응답 내에 존재하는지 확인합니다. 만약 JSON 응답에 다른 속성들이 추가로 포함되어 있어도, 지정한 조각(fragment)이 존재하기만 하면 테스트는 통과합니다.

assertJsonCount​

응답 JSON에서 지정한 키의 배열 요소 개수가 기대한 수와 일치하는지 검증합니다.

$response->assertJsonCount($count, $key = null);

assertJsonFragment​

응답 내용 어딘가에 지정한 JSON 데이터 조각이 포함되어 있는지 검증합니다.

Route::get('/users', function () {
    return [
        'users' => [
            [
                'name' => 'Taylor Otwell',
            ],
        ],
    ];
});

$response->assertJsonFragment(['name' => 'Taylor Otwell']);

assertJsonMissing​

응답에 지정한 JSON 데이터가 포함되어 있지 않은지 검증합니다.

$response->assertJsonMissing(array $data);

assertJsonMissingExact​

응답에 지정한 JSON 데이터가 정확하게 포함되어 있지 않은지 검증합니다.

$response->assertJsonMissingExact(array $data);

assertJsonMissingValidationErrors​

응답에서 주어진 키들에 대한 JSON 유효성 검증 에러가 없는지 확인합니다.

$response->assertJsonMissingValidationErrors($keys);

[!TIP] 더 범용적인 assertValid 메서드를 사용하여 응답에 JSON 형식의 유효성 검증 에러가 없고, 세션에 에러가 플래시되지 않았는지도 함께 검증할 수 있습니다.

assertJsonPath​

응답 JSON의 특정 경로에 지정한 데이터가 존재하는지 검증합니다.

$response->assertJsonPath($path, $expectedValue);

예를 들어, 애플리케이션이 다음과 같은 JSON 응답을 반환한다면:

{
    "user": {
        "name": "Steve Schoger"
    }
}

아래와 같이 user 객체의 name 속성이 기대하는 값과 일치하는지 검증할 수 있습니다.

$response->assertJsonPath('user.name', 'Steve Schoger');

assertJsonStructure​

응답이 지정한 JSON 구조를 가지고 있는지 확인합니다.

$response->assertJsonStructure(array $structure);

예를 들어, 애플리케이션이 아래와 같은 JSON 응답을 반환한다면:

{
    "user": {
        "name": "Steve Schoger"
    }
}

다음과 같이 JSON 구조 검증을 할 수 있습니다.

$response->assertJsonStructure([
    'user' => [
        'name',
    ]
]);

또한, 애플리케이션이 다음처럼 객체의 배열을 포함하는 JSON 응답을 반환할 수도 있습니다.

{
    "user": [
        {
            "name": "Steve Schoger",
            "age": 55,
            "location": "Earth"
        },
        {
            "name": "Mary Schoger",
            "age": 60,
            "location": "Earth"
        }
    ]
}

이 경우 * 문자를 사용해서 배열 내 모든 객체의 구조를 검증할 수 있습니다.

$response->assertJsonStructure([
    'user' => [
        '*' => [
             'name',
             'age',
             'location'
        ]
    ]
]);

assertJsonValidationErrors​

응답 결과 주어진 키에 대해 JSON 유효성 검증 에러가 있는지 확인합니다. 이 메서드는 유효성 검증 에러가 세션에 플래시되지 않고 JSON 구조로 반환되는 경우에 사용해야 합니다.

$response->assertJsonValidationErrors(array $data, $responseKey = 'errors');

[!TIP] 더 범용적인 assertInvalid 메서드를 사용하면, 응답에 JSON 형식의 유효성 검증 에러가 있거나, 또는 에러가 세션에 플래시된 경우 모두 검증할 수 있습니다.

assertJsonValidationErrorFor​

응답에서 주어진 키에 대해 JSON 유효성 검증 에러가 "하나라도" 있는지 확인합니다.

$response->assertJsonValidationErrorFor(string $key, $responseKey = 'errors');

assertLocation​

응답의 Location 헤더에 지정한 URI 값이 있는지 검증합니다.

$response->assertLocation($uri);

assertNoContent​

응답이 지정한 HTTP 상태 코드(기본값 204)를 갖고, 콘텐츠가 없는지 확인합니다.

$response->assertNoContent($status = 204);

assertNotFound​

응답이 "찾을 수 없음(404)" HTTP 상태 코드를 가지는지 확인합니다.

$response->assertNotFound();

assertOk​

응답이 200 HTTP 상태 코드를 가지는지 확인합니다.

$response->assertOk();

assertPlainCookie​

응답에 암호화되지 않은 지정한 쿠키가 포함되어 있는지 확인합니다.

$response->assertPlainCookie($cookieName, $value = null);

assertRedirect​

응답이 지정한 URI로 리다이렉트되는지 확인합니다.

$response->assertRedirect($uri);

assertRedirectContains​

응답이 주어진 문자열을 포함하는 URI로 리다이렉트되는지 확인합니다.

$response->assertRedirectContains($string);

assertRedirectToSignedRoute​

응답이 지정한 서명된(signed) 라우트로 리다이렉트되는지 확인합니다.

$response->assertRedirectToSignedRoute($name = null, $parameters = []);

assertSee​

응답 내에 지정한 문자열이 포함되어 있는지 검증합니다. 두 번째 인자로 false를 지정하지 않는 한, 입력한 문자열은 자동 이스케이프됩니다.

$response->assertSee($value, $escaped = true);

assertSeeInOrder​

응답에 지정한 여러 문자열이 해당 순서대로 포함되어 있는지 검증합니다. 두 번째 인자로 false를 지정하지 않는 한, 각 문자열은 자동 이스케이프 처리됩니다.

$response->assertSeeInOrder(array $values, $escaped = true);

assertSeeText​

응답 텍스트에 지정 문자열이 포함되어 있는지 확인합니다. 두 번째 인자가 false가 아니면 지정한 문자열은 자동 이스케이프 처리됩니다. 검증 전, 응답 내용은 PHP의 strip_tags 함수로 태그가 제거된 후 처리됩니다.

$response->assertSeeText($value, $escaped = true);

assertSeeTextInOrder​

응답 텍스트에 지정한 여러 문자열이 해당 순서대로 포함되어 있는지 확인합니다. 두 번째 인자가 false가 아닌 한 각 문자열은 자동 이스케이프 처리되고, 응답 텍스트는 PHP의 strip_tags로 태그가 제거된 후 검증됩니다.

$response->assertSeeTextInOrder(array $values, $escaped = true);

assertSessionHas​

세션에 지정한 데이터가 포함되어 있는지 검증합니다.

$response->assertSessionHas($key, $value = null);

필요하다면, assertSessionHas 메서드의 두 번째 인수로 클로저를 전달할 수 있습니다. 해당 클로저가 true를 반환하면 어서션이 통과합니다.

$response->assertSessionHas($key, function ($value) {
    return $value->name === 'Taylor Otwell';
});

assertSessionHasInput​

플래시된 입력 값 배열에 지정한 값이 세션에 있는지 확인합니다.

$response->assertSessionHasInput($key, $value = null);

필요하다면, assertSessionHasInput 메서드의 두 번째 인수로 클로저를 전달할 수 있습니다. 해당 클로저가 true를 반환하면 assertion은 통과합니다.

$response->assertSessionHasInput($key, function ($value) {
    return Crypt::decryptString($value) === 'secret';
});

assertSessionHasAll​

세션에 지정한 키-값 쌍 배열이 모두 존재하는지 확인합니다.

$response->assertSessionHasAll(array $data);

예를 들어, 애플리케이션의 세션에 name과 status 키가 있을 경우, 아래와 같이 두 값 모두 존재하고 특정 값인지 확인할 수 있습니다.

$response->assertSessionHasAll([
    'name' => 'Taylor Otwell',
    'status' => 'active',
]);

assertSessionHasErrors​

세션에 지정한 $keys에 대한 에러가 포함되어 있는지 확인합니다. $keys가 연관 배열(associative array)인 경우, 각 필드(키)에 해당하는 특정 에러 메시지(값)가 세션에 있는지 검증합니다. 이 메서드는 유효성 검증 오류가 JSON 형태로 반환되는 대신 세션에 플래시(저장)될 때 테스트에 사용합니다.

$response->assertSessionHasErrors(
    array $keys, $format = null, $errorBag = 'default'
);

예를 들어, 세션에 플래시된 name과 email 필드의 유효성 검증 에러 메시지가 있는지 확인하려면 다음과 같이 사용할 수 있습니다.

$response->assertSessionHasErrors(['name', 'email']);

또는, 특정 필드에 원하는 유효성 검증 에러 메시지가 포함되어 있는지 체크할 수도 있습니다.

$response->assertSessionHasErrors([
    'name' => 'The given name was invalid.'
]);

assertSessionHasErrorsIn​

지정한 에러 백 안에서 주어진 $keys에 대한 에러가 세션에 있는지 확인합니다. $keys가 연관 배열이면, 해당 에러 백에 각 필드(키)에 대한 특정 에러 메시지(값)가 존재하는지 검증합니다.

$response->assertSessionHasErrorsIn($errorBag, $keys = [], $format = null);

assertSessionHasNoErrors​

세션에 유효성 검증 에러가 전혀 없는지 확인합니다.

$response->assertSessionHasNoErrors();

assertSessionDoesntHaveErrors​

세션에 지정한 키에 대해 유효성 검증 에러가 없는지 확인합니다.

$response->assertSessionDoesntHaveErrors($keys = [], $format = null, $errorBag = 'default');

assertSessionMissing​

세션에 지정한 키가 존재하지 않는지 확인합니다.

$response->assertSessionMissing($key);

assertStatus​

응답의 HTTP 상태 코드가 지정한 값과 일치하는지 확인합니다.

$response->assertStatus($code);

assertSuccessful​

응답이 성공 상태 코드(200 이상 300 미만)인지 확인합니다.

$response->assertSuccessful();

assertUnauthorized​

응답의 HTTP 상태 코드가 인증되지 않음(401)인지 확인합니다.

$response->assertUnauthorized();

assertUnprocessable​

응답의 HTTP 상태 코드가 처리할 수 없음(422)인지 확인합니다.

$response->assertUnprocessable();

assertValid​

응답에 지정한 키에 대한 유효성 검증 에러가 없는지 확인합니다. 이 메서드는 유효성 검증 에러가 JSON 구조로 반환되거나 세션에 플래시된 경우 모두 활용할 수 있습니다.

// 유효성 검증 에러가 없는지 확인합니다.
$response->assertValid();

// 지정한 키에 대해 에러가 없는지 확인합니다.
$response->assertValid(['name', 'email']);

assertInvalid​

응답에 지정한 키에 대한 유효성 검증 에러가 존재하는지 확인합니다. 이 메서드 역시 유효성 검증 에러가 JSON 형태이거나 세션에 플래시된 경우 모두 사용할 수 있습니다.

$response->assertInvalid(['name', 'email']);

또한, 특정 키에 대해 원하는 유효성 검증 에러 메시지를 검증할 수도 있습니다. 이때 전체 메시지나 일부 문자만 일치하도록 지정할 수 있습니다.

$response->assertInvalid([
    'name' => 'The name field is required.',
    'email' => 'valid email address',
]);

assertViewHas​

응답 뷰(view)가 특정 데이터를 포함하고 있는지 확인합니다.

$response->assertViewHas($key, $value = null);

assertViewHas 메서드의 두 번째 인수로 클로저를 전달해, 특정 뷰 데이터 값을 확인하는 것도 가능합니다.

$response->assertViewHas('user', function (User $user) {
    return $user->name === 'Taylor';
});

또한, 뷰 데이터는 응답 객체의 배열 변수를 사용해 직접 접근할 수 있으므로, 값을 편리하게 검사할 수 있습니다.

$this->assertEquals('Taylor', $response['name']);

assertViewHasAll​

응답 뷰에 지정한 여러 데이터가 모두 포함되어 있는지 확인합니다.

$response->assertViewHasAll(array $data);

이 메서드는 단순히 뷰에 지정한 여러 키로 데이터가 존재하는지만 검사할 때 사용할 수 있습니다.

$response->assertViewHasAll([
    'name',
    'email',
]);

또는, 뷰 데이터가 존재하면서 동시에 특정 값을 가지고 있는지까지 검사할 수도 있습니다.

$response->assertViewHasAll([
    'name' => 'Taylor Otwell',
    'email' => '[email protected],',
]);

assertViewIs​

해당 라우트에서 반환된 뷰가 지정한 뷰인지 확인합니다.

$response->assertViewIs($value);

assertViewMissing​

애플리케이션 응답에서 반환된 뷰에 해당 데이터 키가 아예 존재하지 않는지 확인합니다.

$response->assertViewMissing($key);

인증 관련 Assertion​

라라벨은 애플리케이션의 기능 테스트에서 활용할 수 있는 다양한 인증 관련 assertion도 제공합니다. 이 메서드들은 get, post 등에서 반환하는 Illuminate\Testing\TestResponse 인스턴스가 아니라, 테스트 클래스 자체에서 호출해야 한다는 점에 유의하세요.

assertAuthenticated​

사용자가 인증되었는지 확인합니다.

$this->assertAuthenticated($guard = null);

assertGuest​

사용자가 인증되지 않았는지(게스트인지) 확인합니다.

$this->assertGuest($guard = null);

assertAuthenticatedAs​

특정 사용자가 인증되었는지 확인합니다.

$this->assertAuthenticatedAs($user, $guard = null);