10.如何测试验证错误

未匹配的标注

本节说明

  • 对应视频第 10 小节:How To Test Validation Errors

本节内容

在开始本节内容之前,我们首先来看一下an_authenticated_user_can_create_new_forum_threads测试:
forum\tests\Feature\CreateThreadsTest.php

.
.
/** @test */
public function an_authenticated_user_can_create_new_forum_threads()
{
    // Given we have a signed in user
    $this->signIn();  // 已登录用户

    // When we hit the endpoint to cteate a new thread
    $thread = create('App\Thread');
    $this->post('/threads',$thread->toArray());

    // Then,when we visit the thread
    // We should see the new thread
    $this->get($thread->path())
        ->assertSee($thread->title)
        ->assertSee($thread->body);
}
.
.

如果我们注释掉下面这行:

$this->post('/threads',$thread->toArray());

再运行测试的话依然可以通过:
file
这是因为我们使用了create()方法,而create()方法会获取模型实例并且 入库,这样我们的测试就没有起到原有的作用。但是,如果我们把create()改成make()再进行测试:

$thread = make('App\Thread');

file
测试会不通过,因为我们使用了make()方法,模型实例并未入库,当然也就不存在$thread->path()/threads/{channel}/{id}这样的url,所以会抛出NotFoundHttpException的异常。
现在进行修复:

.
.
/** @test */
public function an_authenticated_user_can_create_new_forum_threads()
{
    // Given we have a signed in user
    $this->signIn();  // 已登录用户

    // When we hit the endpoint to cteate a new thread
    $thread = make('App\Thread');
    $response = $this->post('/threads',$thread->toArray());

    // Then,when we visit the thread
    // We should see the new thread
    $this->get($response->headers->get('Location'))
        ->assertSee($thread->title)
        ->assertSee($thread->body);
}
.
.

$responseIlluminate\Foundation\Testing\TestResponse的一个实例化对象,通过$response->headers->get('Location')获取到url,类似于:forum.test/threads/debitis/1
运行测试:
file
OK,现在的测试已经没问题了,接下来让我们进入本节内容。
在当前的进度下,我们已经可以发布ThreadReply,但是我们并没有对输入的内容做限制。本节我们要来学习Laravel Validation的测试。
首先我们来对$threadtitle字段做必填校验:
forum\tests\Feature\CreateThreadsTest.php

.
.
/** @test */
public function a_thread_requires_a_title()
{
    $this->signIn();

    $thread = make('App\Thread',['title' => null]);

    $this->post('/threads',$thread->toArray())
        ->assertSessionHasErrors('title');
}
.
.

forum\app\Http\Controllers\ThreadsController.php

.
.
public function store(Request $request)
{
    $this->validate($request,[
       'title' => 'required'
    ]);

    $thread = Thread::create([
        'user_id' => auth()->id(),
        'channel_id' => request('channel_id'),
        'title' => request('title'),
        'body' => request('body'),
    ]);

    return redirect($thread->path());
}
.
.

如果此时运行测试:

$ APP_ENV=testing phpunit --filter a_thread_requires_a_title

file
我们并不需要捕获此异常,因此我们需要调用withExceptionHandling()方法:

$this->withExceptionHandling()->signIn();

再次运行测试:
file
现在让我们来想一下,我们对提交的$thread的内容不会仅仅检查一个title字段。假如我们新增加一个验证字段或者验证规则,我们就要多写一次以下代码:

$this->withExceptionHandling()->signIn();

$thread = make('App\Thread',['title' => null]);

$this->post('/threads',$thread->toArray())

这明显违背了 DRY 原则:Don't Repeat Youself !作为开发人员,我们想要写出高质量的代码,应时刻牢记这一基本原则,不写重复的代码。所以我们来进行重构,将以上代码片段抽离成一个新的方法,然后验证的时候去调用它即可:

.
.
/** @test */
public function a_thread_requires_a_title()
{
    $this->publishThread(['title' => null])
        ->assertSessionHasErrors('title');
}

public function publishThread($overrides = [])
{
    $this->withExceptionHandling()->signIn();

    $thread = make('App\Thread',$overrides);

    return $this->post('/threads',$thread->toArray());
}
.
.

测试一下,通过:
file
接下来我们验证 Thread 的其他信息:

  • user_id的值为auth()->id(),即当前登录用户的id。这个值一定存在,所以我们不用验证;
  • channel_id,需要验证为必填,并且已存在;
  • body需要验证为必填;

修改store()方法的验证规则:

public function store(Request $request)
{
    $this->validate($request,[
       'title' => 'required',
        'body' => 'required',
        'channel_id' => 'required|exists:channels,id'
    ]);

    $thread = Thread::create([
        'user_id' => auth()->id(),
        'channel_id' => request('channel_id'),
        'title' => request('title'),
        'body' => request('body'),
    ]);

    return redirect($thread->path());
}

注:exists 方法详见 Laravel 的表单验证机制详解

得益于我们前面抽离出来的publishThread()方法,我们可以方便的新建测试:

.
.
/** @test */
public function a_thread_requires_a_title()
{
    $this->publishThread(['title' => null])
        ->assertSessionHasErrors('title');
}

/** @test */
public function a_thread_requires_a_body()
{
    $this->publishThread(['body' => null])
        ->assertSessionHasErrors('body');
}

/** @test */
public function a_thread_requires_a_valid_channel()
{
    factory('App\Channel',2)->create(); // 新建两个 Channel,id 分别为 1 跟 2

    $this->publishThread(['channel_id' => null])
        ->assertSessionHasErrors('channel_id');

    $this->publishThread(['channel_id' => 999])  // channle_id 为 999,是一个不存在的 Channel
        ->assertSessionHasErrors('channel_id');
}
.
.

运行一下新建的两个测试:
file
如果在测试中,我们给channel_id赋值为已存在的id,那么我们的测试应该会不通过:

/** @test */
public function a_thread_requires_a_valid_channel()
{
    factory('App\Channel',2)->create(); // 新建两个 Channel,id 分别为 1 跟 2

    $this->publishThread(['channel_id' => null])
        ->assertSessionHasErrors('channel_id');

    $this->publishThread(['channel_id' => 2])  // channle_id 为 2,是一个存在的 Channel
        ->assertSessionHasErrors('channel_id');
}

file
接下来按照同样的思路,我们对添加回复进行验证:
forum\app\Http\Controllers\RepliesController.php

.
.
public function store($channelId,Thread $thread)
{
    $this->validate(request(),['body' => 'required']);

    $thread->addReply([
        'body' => request('body'),
        'user_id' => auth()->id(),
    ]);

    return back();
}
.
.

forum\tests\Feature\ParticipateInForumTest.php

.
.
/** @test */
public function a_reply_requires_a_body()
{
    $this->withExceptionHandling()->signIn();

    $thread = create('App\Thread');
    $reply = make('App\Reply',['body' => null]);

    $this->post($thread->path() . '/replies',$reply->toArray())
        ->assertSessionHasErrors('body');
}
.
.

运行一下新建的测试:
file
当然,我们全部的测试任然有效:
file

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
贡献者:1
讨论数量: 2
发起讨论 查看所有版本


幽弥狂
我有个疑问?
0 个点赞 | 1 个回复 | 问答