Laravel 测试之:HTTP 测试

基础介绍

Laravel 为 HTTP 请求的生成和发送操作、输出的检查都提供了非常流利的 API。例如,你可以看看下面的这个测试用例:

  1. <?php
  2. namespace Tests\Feature;
  3. use Tests\TestCase;
  4. use Illuminate\Foundation\Testing\WithoutMiddleware;
  5. use Illuminate\Foundation\Testing\DatabaseMigrations;
  6. use Illuminate\Foundation\Testing\DatabaseTransactions;
  7. class ExampleTest extends TestCase
  8. {
  9. /**
  10. * A basic test example.
  11. *
  12. * @return void
  13. */
  14. public function testBasicTest()
  15. {
  16. $response = $this->get('/');
  17. $response->assertStatus(200);
  18. }
  19. }

get 方法会创建一个 GET 请求来请求你的应用,而 assertStatus 方法断言返回的响应是给定的 HTTP 状态码。除了这个简单的断言之外,Laravel 也包含检查响应标头、内容、 JSON 结构等等的各种断言。

Session / 认证

Laravel 提供了几个可在测试时使用 Session 的辅助函数。首先,你需要传递一个数组给 withSession 方法来设置 Seesion 数据。这让你在应用程序的测试请求发送之前,先给数据加载 Session 变得简单:

  1. <?php
  2. class ExampleTest extends TestCase
  3. {
  4. public function testApplication()
  5. {
  6. $response = $this->withSession(['foo' => 'bar'])
  7. ->get('/');
  8. }
  9. }

当然,一般使用 Session 时都是用于维持用户的状态,如认证用户。actingAs 辅助函数提供了简单的方式来让指定的用户认证为当前的用户。例如,我们可以使用 模型工厂 来生成并认证用户:

  1. <?php
  2. use App\User;
  3. class ExampleTest extends TestCase
  4. {
  5. public function testApplication()
  6. {
  7. $user = factory(User::class)->create();
  8. $response = $this->actingAs($user)
  9. ->withSession(['foo' => 'bar'])
  10. ->get('/')
  11. }
  12. }

你也可以通过传递 guard 名称作为 actingAs 的第二参数以指定用户通过哪种 guard 来认证:

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

测试 JSON APIs

Laravel 也提供了几个辅助函数来测试 JSON APIs 及其响应。举例来说,jsongetpostputpatchdelete 方法可以用于发出各种 HTTP 动作的请求。你也可以轻松的传入数据或标头到这些方法上。首先,让我们来编写一个测试,将 POST 请求发送至 /user ,并断言其会返回预期数据:

  1. <?php
  2. class ExampleTest extends TestCase
  3. {
  4. /**
  5. * A basic functional test example.
  6. *
  7. * @return void
  8. */
  9. public function testBasicExample()
  10. {
  11. $response = $this->json('POST', '/user', ['name' => 'Sally']);
  12. $response
  13. ->assertStatus(200)
  14. ->assertJson([
  15. 'created' => true,
  16. ]);
  17. }
  18. }

{tip} assertJson 方法会将响应转换为数组并且利用 PHPUnit::assertArraySubset 方法来验证传入的数组是否在应用返回的 JSON 中。也就是说,即使有其它的属性存在于该 JSON 响应中,但是只要指定的片段存在,此测试仍然会通过。

验证完全匹配的 JSON

如果你想验证传入的数组是否与应用程序返回的 JSON 完全 匹配,你可以使用 assertExactJson 方法:

  1. <?php
  2. class ExampleTest extends TestCase
  3. {
  4. /**
  5. * A basic functional test example.
  6. *
  7. * @return void
  8. */
  9. public function testBasicExample()
  10. {
  11. $response = $this->json('POST', '/user', ['name' => 'Sally']);
  12. $response
  13. ->assertStatus(200)
  14. ->assertExactJson([
  15. 'created' => true,
  16. ]);
  17. }
  18. }

测试文件上传

Illuminate\Http\UploadedFile 类提供了一个 fake 方法,可用于生成用于测试的模拟文件或图像。这与 Storage facade 的 fake 方法结合使用,极大地简化文件上传的测试。例如,你可以结合这两个功能轻松测试头像上传表单:

  1. <?php
  2. namespace Tests\Feature;
  3. use Tests\TestCase;
  4. use Illuminate\Http\UploadedFile;
  5. use Illuminate\Support\Facades\Storage;
  6. use Illuminate\Foundation\Testing\WithoutMiddleware;
  7. use Illuminate\Foundation\Testing\DatabaseMigrations;
  8. use Illuminate\Foundation\Testing\DatabaseTransactions;
  9. class ExampleTest extends TestCase
  10. {
  11. public function testAvatarUpload()
  12. {
  13. Storage::fake('avatars');
  14. $response = $this->json('POST', '/avatar', [
  15. 'avatar' => UploadedFile::fake()->image('avatar.jpg')
  16. ]);
  17. // 断言文件已存储
  18. Storage::disk('avatars')->assertExists('avatar.jpg');
  19. // 断言文件不存在
  20. Storage::disk('avatars')->assertMissing('missing.jpg');
  21. }
  22. }

自定义模拟文件

当使用 fake 方法创建文件时,你可以指定图片的宽度、高度和大小,以便更好的测试你的验证规则:

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

除了创建图片,你还可以使用 create 方法创建任何其他类型的文件:

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

可用的断言方法

Laravel 为你的 PHPUnit 测试提供了各种各样的自定义断言方法。jsongetpostputdelete 这些测试方法返回的响应都可以使用这些断言方法:

Method Description
$response->assertStatus($code); 断言该响应具有给定的状态码。
$response->assertRedirect($uri); 断言该响应被重定向至指定的 URI。
$response->assertHeader($headerName, $value = null); 断言该响应存在指定的标头。
$response->assertCookie($cookieName, $value = null); 断言该响应包含了指定的 cookie。
$response->assertPlainCookie($cookieName, $value = null); 断言该响应包含了指定的 cookie (未加密)。
$response->assertSessionHas($key, $value = null); 断言该 session 包含指定数据。
$response->assertSessionHasErrors(array $keys); 断言该 session 包含指定字段的错误信息。
$response->assertSessionMissing($key); 断言该 session 不包含指定键。
$response->assertJson(array $data); 断言该响应包含指定 JSON 数据。
$response->assertJsonFragment(array $data); 断言该响应包含指定 JSON 片段。
$response->assertExactJson(array $data); 断言该响应包含完全匹配的 JSON 数据。
$response->assertJsonStructure(array $structure); 断言该响应存在指定 JSON 结构。
$response->assertViewHas($key, $value = null); 断言该响应视图存在指定数据。

{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译,详见 翻译召集帖

文档永久地址: http://d.laravel-china.org