测试应用程序

简介

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

<?php

use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseTransactions;

class ExampleTest extends TestCase
{
    /**
     * 基本的测试用例。
     *
     * @return void
     */
    public function testBasicExample()
    {
        $this->visit('/')
             ->see('Laravel 5')
             ->dontSee('Rails');
    }
}

visit 方法会创建一个 GET 请求,see 方法则断言在返回的响应中会有指定的文本,dontSee 方法断言在返回的响应中不会有指定的文本。这是 Laravel 所提供的最基本的应用程序测试。

你也可以使用 visitRoute 方法来创建一个 GET 请求访问命名路由。

$this->visitRoute('profile');

$this->visitRoute('profile', ['user' => 1]);

与你的应用程序进行交互

当然,除了断言文本是否存在于一个指定的响应中,你还可以做更多的交互。让我们来看看点击链接及填写表单的例子:

与链接交互

在这个测试中,我们会生成一个请求并「点击」返回响应中的链接,接着断言我们会停留在指定的 URI 上。举个例子,假设在响应中有个链接,并写着「About Us」:

<a href="/about-us">About Us</a>

我们可以编写一个测试来填写此表单,并检查结果:

public function testBasicExample()
{
    $this->visit('/')
         ->click('About Us')
         ->seePageIs('/about-us');
}

你也可以使用 seeRouteIs 方法来检查用户是否跳转到了正确的路由:

->seeRouteIs('profile', ['user' => 1]);

与表单交互

Laravel 还提供了几种用于测试表单的方法。通过 typeselectcheckattachpress 方法让你与表单的所有输入框进行交互。举个例子,设想有一个在应用程序注册页面的表单:

<form action="/register" method="POST">
    {{ csrf_field() }}

    <div>
        Name: <input type="text" name="name">
    </div>

    <div>
        <input type="checkbox" value="yes" name="terms"> Accept Terms
    </div>

    <div>
        <input type="submit" value="Register">
    </div>
</form>

我们可以编写一个测试来填写此表单,并检查结果:

public function testNewUserRegistration()
{
    $this->visit('/register')
         ->type('Taylor', 'name')
         ->check('terms')
         ->press('Register')
         ->seePageIs('/dashboard');
}

当然,如果你的表单中包含了类似单选框或下拉式菜单的其它输入框,也可以很轻松的填入这些类型的区域。以下是每个表单的方法操作列表:

方法 说明
$this->type($text, $elementName) 「输入(type)」文本在一个指定的区域
$this->select($value, $elementName) 「选择(select)」一个单选框或下拉式菜单的区域
$this->check($elementName) 「勾选(check)」一个复选框的区域
$this->uncheck($elementName) 「取消勾选(uncheck)」一个复选框的区域
$this->attach($pathToFile, $elementName) 「附加(attach)」一个文件至表单
$this->press($buttonTextOrElementName) 「按下(press)」一个指定文本或名称的按钮 text or name.

文件上传

如果你的表单包含 上传文件 的输入框类型,则可以使用 attach 方法来附加文件:

public function testPhotoCanBeUploaded()
{
    $this->visit('/upload')
         ->attach($pathToFile, 'photo')
         ->press('Upload')
         ->see('Upload Successful!');
}

测试 JSON APIs

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

<?php

class ExampleTest extends TestCase
{
    /**
     * 基本的功能测试示例。
     *
     * @return void
     */
    public function testBasicExample()
    {
        $this->json('POST', '/user', ['name' => 'Sally'])
             ->seeJson([
                 'created' => true,
             ]);
    }
}

{tip} seeJson 方法会将传入的数组转换成 JSON,并验证该 JSON 片段是否存在于应用程序返回的 JSON 响应中的 任何位置。也就是说,即使有其它的属性存在于该 JSON 响应中,但是只要指定的片段存在,此测试便会通过。

验证完全匹配的 JSON

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

<?php

class ExampleTest extends TestCase
{
    /**
     * 基本的功能测试示例。
     *
     * @return void
     */
    public function testBasicExample()
    {
        $this->json('POST', '/user', ['name' => 'Sally'])
             ->seeJsonEquals([
                 'created' => true,
             ]);
    }
}

验证 JSON 的结构匹配

你可以使用 seeJsonStructure 来验证 JSON 结构是否符合你的预期:

<?php

class ExampleTest extends TestCase
{
    /**
     * 基本的功能测试示例。
     *
     * @return void
     */
    public function testBasicExample()
    {
        $this->get('/user/1')
             ->seeJsonStructure([
                 'name',
                 'pet' => [
                     'name', 'age'
                 ]
             ]);
    }
}

上面这个例子展示接受到的数据会有一个 name 属性和一个拥有 nameage 属性的嵌套 pet 对象。seeJsonStructure 并不会因为响应结果中包含额外的属性而失败。比如,即使响应中 pet 对象含有一个 weight 属性,测试依旧会通过。

你可以使用 * 来假设所有的列表内容都包含至少数组里面的内容:

<?php

class ExampleTest extends TestCase
{
    /**
     * 基本的功能测试示例。
     *
     * @return void
     */
    public function testBasicExample()
    {
        // 每一个列表里至少拥有 id, name 和 email 属性
        $this->get('/users')
             ->seeJsonStructure([
                 '*' => [
                     'id', 'name', 'email'
                 ]
             ]);
    }
}

你也可以灵活的使用 * 做嵌套。在下面这个实例中,我们可以断言在响应数据中每个 user 都包含指定的属性,而且用户的每个 pet 对象也包含指定的属性集:

$this->get('/users')
     ->seeJsonStructure([
         '*' => [
             'id', 'name', 'email', 'pets' => [
                 '*' => [
                     'name', 'age'
                 ]
             ]
         ]
     ]);

Sessions 和认证

Laravel 提供了几个可在测试时使用 Session 的辅助函数。首先,你需要设置 Session 数据至指定的数组中,并使用 withSession 方法。在应用程序的测试请求发送之前,可先给数据加载 session:

<?php

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

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

<?php

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

        $this->actingAs($user)
             ->withSession(['foo' => 'bar'])
             ->visit('/')
             ->see('Hello, '.$user->name);
    }
}

你也可以使用 actingAs 来指定用户使用哪个 guard:

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

停用中间件

测试应用程序时,你会发现,在某些测试中停用 中间件 是很方便的。这让你可以隔离任何中间件的所有影响,以便更好的测试路由及控制器。Laravel 包含了一个简洁的 WithoutMiddleware trait,你能在测试类中使用它来自动停用所有的中间件:

<?php

use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;

class ExampleTest extends TestCase
{
    use WithoutMiddleware;

    //
}

如果你只想要在某几个测试方法中停用中间件,则可以在测试方法中调用 withoutMiddleware 方法:

<?php

class ExampleTest extends TestCase
{
    /**
     * 基本的功能测试示例。
     *
     * @return void
     */
    public function testBasicExample()
    {
        $this->withoutMiddleware();

        $this->visit('/')
             ->see('Laravel 5');
    }
}

自定义 HTTP 请求

如果你想要创建一个自定义的 HTTP 请求到应用程序上,并获取完整的 Illuminate\Http\Response 对象,则可以使用 call 方法:

public function testApplication()
{
    $response = $this->call('GET', '/');

    $this->assertEquals(200, $response->status());
}

如果你创建的是 POSTPUT、或是 PATCH 请求,则可以在请求时传入一个数组作为输入数据。当然,你也可以在路由及控制器中通过 请求实例 取用这些数据:

   $response = $this->call('POST', '/user', ['name' => 'Taylor']);

PHPUnit 断言

方法 描述
->assertResponseOk(); 断言客户端的响应拥有 OK 状态码。
->assertResponseStatus($code); 断言客户端的响应拥有指定的状态码。
->assertViewHas($key, $value = null); 断言响应视图拥有指定的部分绑定数据。
->assertViewHasAll(array $bindings); 断言响应视图里存在传参数组里的所有数据
->assertViewMissing($key); 断言响应视图拥有指定的绑定数据列表。
->assertRedirectedTo($uri, $with = []); 断言客户端是否被重定向至指定的 URI。
->assertRedirectedToRoute($name, $parameters = [], $with = []); 断言客户端是否被重定向到指定的路由。
->assertRedirectedToAction($name, $parameters = [], $with = []); 断言客户端是否被重定向到指定的行为。
->assertSessionHas($key, $value = null); 断言 session 中有指定的值。
->assertSessionHasAll(array $bindings); 断言 session 中有指定的列表值。
->assertSessionHasErrors($bindings = [], $format = null); 断言 session 有错误的绑定。
->assertHasOldInput(); 断言 session 有旧的输入数据。
->assertSessionMissing($key); 断言 session 中没有指定的值。

译者署名

用户名 头像 职能 签名
@JobsLong 翻译 我的个人主页:http://jobslong.com

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

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

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