はじめに

Laravel は、HTTP リクエストの生成と出力の検査の両方に非常に流暢な API を提供します。たとえば、次のテスト ケースを確認できます。

<?php
    namespace Tests\Feature;
    use Tests\TestCase;
    use Illuminate\Foundation\Testing\RefreshDatabase;
    use Illuminate\Foundation\Testing\WithoutMiddleware;
    class ExampleTest extends TestCase{    
    /**
     * 一个基础的测试用例。
     *
     * @return void
     */   
     public function testBasicTest() 
        {     
           $response = $this->get('/');        
           $response->assertStatus(200);  
         }
      }

get メソッドは、アプリケーションへの GET リクエストを作成し、assertStatusメソッドは、返された応答が指定された HTTP ステータス コードであることをアサートします。この単純なアサーションに加えて、Laravel には応答ヘッダー、コンテンツ、JSON、構造などをチェックするさまざまなアサーションも含まれています。

カスタム リクエスト ヘッダー

アプリケーションに送信する前に withHeaders メソッドを使用できます。以前のカスタムリクエストのヘッダー。必要なカスタム ヘッダーを追加できます。

<?php
    class ExampleTest extends TestCase{
     /**
     * 一个基础的功能测试用例。
     *
     * @return void
     */  
       public function testBasicExample() 
          {     
             $response = $this->withHeaders([        
                 'X-Header' => 'Value',        
               ])->json('POST', '/user', ['name' => 'Sally']);        
              $response      
                    ->assertStatus(201)            
                    ->assertJson([        
                            'created' => true,           
                            ]); 
                         }
                      }

{tip} CSRF ミドルウェアは、テストの実行時に自動的に無効になります。

セッション/認証

Laravel は、HTTP テスト中に使用できるいくつかの補助機能を提供します。まず、配列を withSession メソッドに渡してセッション データを設定する必要があります。これにより、アプリケーションのテスト リクエストを送信する前に、セッションにデータをロードすることが簡単になります。

<?php
    class ExampleTest extends TestCase{  
      public function testApplication()  
        {     
           $response = $this->withSession(['foo' => 'bar'])              
                      ->get('/'); 
         }
    }

もちろん、セッションは通常、ユーザーの認証などのユーザー ステータスを維持するために使用されます。 actingAs ヘルパー関数を使用すると、現在のユーザーの認証先となるユーザーを簡単に指定できます。たとえば、ファクトリ モデルを使用してユーザーを生成および認証できます。

<?php
    use App\User;
    class ExampleTest extends TestCase{ 
       public function testApplication()  
         {     
            $user = factory(User::class)->create();        
            $response = $this->actingAs($user)                 
                    ->withSession(['foo' => 'bar'])                        
                    ->get('/');  
          }
     }

また、ガード名を 2 番目の引数として actingAs に渡すことで、ユーザーが認証されるガードを指定することもできます。 :

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

JSON API のテスト

Laravel は、JSON API とその応答をテストするためのいくつかのヘルパー関数も提供します。たとえば、json、get、post、put、patch、delete さまざまな HTTP アクションの送信に使用できます。データとリクエスト ヘッダーをこれらのメソッドに簡単に渡すこともできます。 POST リクエストを /user に書き込み、予期したデータが返されることをアサートすることで、これらの使用を開始しましょう:

<?php
    class ExampleTest extends TestCase{   
     /**
     * 一个简单的功能测试用例。
     *
     * @return void
     */   
     public function testBasicExample() 
        {    
            $response = $this->json('POST', '/user', ['name' => 'Sally']);     
            $response        
                ->assertStatus(201)            
                ->assertJson([         
                       'created' => true,           
                       ]);  
         }
     }

{tip} assertJson メソッドは応答を配列に変換し、PHPUnit::assertArraySubset を利用して、アプリケーションから返された JSON 応答に指定された配列が存在することを確認します。したがって、JSON 応答に他の属性がある場合でも、配列が存在していればテストは合格します。

完全一致の検証

指定された配列 exactly がアプリケーションから返された JSON 結果と一致することを検証する場合は、assertExactJson メソッドを使用する必要があります。 ##

<?php
    class ExampleTest extends TestCase{   
     /**
     * 一个基本的功能测试用例。
     *
     * @return void
     */  
      public function testBasicExample()  
        {     
           $response = $this->json('POST', '/user', ['name' => 'Sally']);        
           $response         
              ->assertStatus(201)            
              ->assertExactJson([           
                   'created' => true,           
                  ]);  
         }
     }

<?php
    namespace Tests\Feature;
    use Tests\TestCase;
    use Illuminate\Http\UploadedFile;
    use Illuminate\Support\Facades\Storage;
    use Illuminate\Foundation\Testing\RefreshDatabase;
    use Illuminate\Foundation\Testing\WithoutMiddleware;
    class ExampleTest extends TestCase{
        public function testAvatarUpload()  
          {    
              Storage::fake('avatars');        
              $file = UploadedFile::fake()->image('avatar.jpg');        
              $response = $this->json('POST', '/avatar', [        
                  'avatar' => $file,      
             ]);       
           // 断言文件已经存储 . . .       
           Storage::disk('avatars')->assertExists($file->hashName());      
          // 断言文件不存在 . . .        
          Storage::disk('avatars')->assertMissing('missing.jpg');   
       }
 }

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

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

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

$response->assertCookieExpired($cookieName);

$response->assertCookieNotExpired($cookieName);

$response->assertCookieMissing($cookieName);

$response->assertDontSee($value);

$response->assertDontSeeText($value);

$response->assertExactJson(array $data);

$response->assertForbidden();

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

$response->assertJson(array $data);

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

$response->assertJsonFragment(array $data);

$response->assertJsonMissing(array $data);

$response->assertJsonMissingExact(array $data);

$response->assertJsonMissingValidationErrors($keys);

$response->assertJsonStructure(array $structure);

$response->assertJsonValidationErrors($keys);

$response->assertLocation($uri);

$response->assertNotFound();

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

$response->assertRedirect($uri);

$response->assertSee($value);

$response->assertSeeInOrder(array $values);

$response->assertSeeText($value);

$response->assertSeeTextInOrder(array $values);

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

$response->assertSessionHasAll(array $data);

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

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

$response->assertSessionHasNoErrors();

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

$response->assertSessionMissing($key);

$response->assertStatus($code);

$response->assertSuccessful();

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