[ Laravel 5.7 文档 ] 测试系列 —— HTTP 测试

  发布时间:   文章分类:PHP 浏览数: 29

文章来源: laravelacademy.org/post/9591.h......, 本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。

简介

Laravel 为生成 HTTP 请求、测试输出提供了流式 API。举个例子,我们 Laravel 提供的测试示例:

<?php

namespace Tests\Feature;

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

class ExampleTest extends TestCase
{
    /**
     * A basic test example.
     *
     * @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' => 'LaravelAcademy',
        ])->json('POST', '/user', ['name' => '学院君']);

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

注:运行测试时,CSRF 中间件会自动被禁止。

会话/认证

Laravel 提供了多个辅助函数用于在 HTTP 测试期间处理会话(Session),首先,你可以使用 withSession 方法来设置会话数据。这对于在发起请求之前加载会话数据很有用:

<?php

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

当然,会话最常见的用途还是维护认证用户的状态。对此,辅助函数 actionAs 方法提供了一个简单的方式来认证当前用户,例如,我们可以使用模型工厂来生成并认证用户:

<?php

use App\User;

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

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

你还可以通过传递 guard 名作为 actionAs 方法的第二个参数来指定使用哪一个 guard 来认证给定用户:

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

测试 JSON API

Laravel 还提供了多个辅助函数用于测试 JSON API 及其响应。例如, jsongetpostputpatchdelete 方法用于通过多种 HTTP 请求方式发出请求。你还可以轻松传递数据和请求头到这些方法。作为开始,我们编写测试来生成 POST 请求到 /user 并断言返回的数据是否是我们所期望的:

<?php

class ExampleTest extends TestCase
{
    /**
     * 基本功能测试示例.
     *
     * @return void
     */
    public function testBasicExample()
    {
        $response = $this->json('POST', '/user', ['name' => '学院君']);

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

注: assertJson 方法将响应转化为数组并使用 PHPUnit::assertArraySubset 验证给定数组在应用返回的 JSON 响应中是否存在。所以,如果在 JSON 响应中存在其它属性,这个测试仍然会通过,只要给定的片段存在即可。

验证JSON匹配

如果你想要验证给定数组和应用返回的 JSON 能够完全匹配,可以使用 assertExactJson 方法:

<?php

class ExampleTest extends TestCase
{
    /**
     * A basic functional test example.
     *
     * @return void
     */
    public function testBasicExample()
    {
        $response = $this->json('POST', '/user', ['name' => '学院君']);

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

测试文件上传

Illuminate\Http\UploadedFile 类提供了一个 fake 方法用于生成假文件或图片进行测试。这一机制和 Storage 门面的 fake 方法联合在一起,极大地简化了文件上传的测试。例如,你可以联合这两个特性来轻松测试头像上传表单:

<?php

namespace Tests\Feature;

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

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

        $response = $this->json('POST', '/avatar', [
            'avatar' => UploadedFile::fake()->image('avatar.jpg')
        ]);

        // Assert the file was stored...
        Storage::disk('avatars')->assertExists('avatar.jpg');

        // Assert a file does not exist...
        Storage::disk('avatars')->assertMissing('missing.jpg');
    }
}

伪造文件自定义

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

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

除了创建图片之外,你还可以使用 create 方法创建其它类型的文件:

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

有效的断言方法

响应断言

Laravel 为 PHPUnit 测试提供了多个自定义的断言方法。这些断言可以通过测试方法 jsongetpostputdelete 返回的响应进行访问:

assertCookie

断言响应包含给定 Cookie:

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

assertCookieExpired

断言响应包含给定 Cookie 并且已过期:

$response->assertCookieExpired($cookieName);

assertCookieNotExpired

断言响应包含给定 Cookie 并且没有过期:

$response->assertCookieNotExpired($cookieName);

assertCookieMissing

断言响应不包含给定 Cookie:

$response->assertCookieMissing($cookieName);

assertDontSee

断言给定字符串不在响应中:

$response->assertDontSee($value);

assertDontSeeText

断言给定字符串不在响应文本中:

$response->assertDontSeeText($value);

assertExactJson

断言响应与给定 JSON 数据完全匹配:

$response->assertExactJson(array $data);

assertForbidden

断言响应包含禁止状态码:

$response->assertForbidden();

assertHeader

断言给定头在响应中是否存在:

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

assertHeaderMissing

断言给定头在响应中不存在:

$response->assertHeaderMissing($headerName);

assertJson

断言响应包含给定 JSON 数据:

$response->assertJson(array $data);

assertJsonCount

断言响应 JSON 包含给定键对应的指定条目数数组:

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

assertJsonFragment

断言响应中包含给定 JSON 片段:

$response->assertJsonFragment(array $data);

assertJsonMissing

断言响应中不包含给定 JSON 片段:

$response->assertJsonMissing(array $data);

assertJsonMissingExact

断言响应中不包含给定完整的 JSON 片段:

$response->assertJsonMissingExact(array $data);

assertJsonStructure

断言响应包含给定 JSON 结构:

$response->assertJsonStructure(array $structure);

assertJsonValidationErrors

断言响应包含给定键的 JSON 验证错误信息:

$response->assertJsonValidationErrors($keys);

assertLocation

断言在响应头 Location 中包含给定 URI 值:

$response->assertLocation($uri);

assertNotFound

断言在响应包含 Not Found 状态码:

$response->assertNotFound();

assertOk

断言在响应包含 200 状态码:

$response->assertOk();

assertPlainCookie

断言响应包含给定 Cookie(未加密):

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

assertRedirect

断言响应重定向到给定 URI:

$response->assertRedirect($uri);

assertSee

断言给定字符串包含在响应中:

$response->assertSee($value);

assertSeeInOrder

断言给定字符串有序包含在响应中:

$response->assertSeeInOrder(array $values);

assertSeeText

断言给定字符串包含在响应文本中:

$response->assertSeeText($value);

assertSeeTextInOrder

断言给定字符串有序包含在响应文本中:

$response->assertSeeTextInOrder(array $values);

assertSessionHas

断言会话中包含给定数据片段:

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

assertSessionHasAll

断言会话中存在给定值列表:

$response->assertSessionHasAll(array $data);

assertSessionHasErrors

断言会话中包含给定字段的错误信息:

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

assertSessionHasErrorsIn

断言会话中包含给定错误:

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

assertSessionHasNoErrors

断言会话中不包含错误:

$response->assertSessionHasNoErrors();

assertSessionMissing

断言会话中不包含给定键:

$response->assertSessionMissing($key);

assertStatus

断言响应中包含给定状态码:

$response->assertStatus($code);

assertSuccessful

断言响应中包含成功状态码:

$response->assertSuccessful();

assertViewHas

断言响应视图包含给定数据片段:

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

assertViewHasAll

断言响应视图包含给定数据列表:

$response->assertViewHasAll(array $data);

assertViewIs

断言给定视图由该路由返回:

$response->assertViewIs($value);

assertViewMissing

断言响应视图不包含绑定数据片段:

$response->assertViewMissing($key);

认证断言

Laravel 还为 PHPUnit 测试提供了一些认证相关的断言:

方法 描述
$this->assertAuthenticated($guard = null); 断言当前用户已认证
$this->assertGuest($guard = null); 断言当前用户未认证
$this->assertAuthenticatedAs($user, $guard = null); 断言给定用户已认证
$this->assertCredentials(array $credentials, $guard = null); 断言给定认证信息有效
$this->assertInvalidCredentials(array $credentials, $guard = null); 断言给定认证信息无效

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 Coder·码农网

码农可能感兴趣的文章:

本文永久链接:www.codercto.com/a/24567.html

相关码农书籍:
C++面向对象程序设计

C++面向对象程序设计

谭浩强 / 清华大学出版社 / 2006-1 / 26.00元

《普通高等教育"十一五"国家级规划教材•中国高等院校计算机基础教育课程体系规划教材:C++面向对象程序设计》作者谭浩强深入调查了我国大学的程序设计课程的现状...

相关码农工具:
随机密码生成器

随机密码生成器

多种字符组合密码

SHA 加密

SHA 加密

SHA 加密工具

CSS 压缩/解压工具

CSS 压缩/解压工具

在线压缩/解压 CSS 代码