Laravel测试驱动开发--功能测试

时间 2020-06-11

标签 laravel 测试驱动开发功能繁體版

原文原文链接

功能测试

测试驱动开发系列文章的最后一篇文章是关于功能测试的，如今的流行的架构是先后端分离因此不少时候咱们并不会像文章里写的那样对响应页面进行功能测试，以前这个系列里的第一篇文章有讲如何对API进行功能测试。php

原文连接：https://medium.com/@jsdecena/...前端

如下是译文：laravel

以前的文章讲述了如何在Laravel中进行正向单元测试和反向单元测试，这篇文章让咱们看看在Laravel中如何作功能测试。功能测试会访问控制器中的方法而后断言响应是否正确。git

我仍将使用以前文章用的Carousel例子，对他进行功能测试。web

建立carousel功能测试

在对你的项目进行功能测试的时候，必定要确保管理后台的功能测试要与前台的功能测试隔离开来。在本例中，我经过命名空间Admin和Front来分离管理后台的测试和前端页面的测试。segmentfault

如今让咱们专一于管理后台carousel的CRUD功能测试。在test/Feature目录里添加CarouselFeatureTest 类。后端

<?php
namespace Tests\Feature\Admin\Carousels;
use Tests\TestCase;
class CarouselFeatureTest extends TestCase
{
    /** @test */
    public function it_can_show_the_create_carousel_page()
    {
       $employee = factory(User::class)->create();
        $this
            ->actingAs($employee, 'admin')
            ->get(route('admin.carousel.create'))
            ->assertStatus(200)
            ->assertSee('Title')
            ->assertSee('Subtitle')
            ->assertSee('Link')
            ->assertSee('Link Text')
            ->assertSee('Image');
    }
}

咱们来分析一下上面的代码。session

咱们须要->actingAs()方法来经过用户认证中间件而且模拟admin用户(若是项目中没有进行使用认证看守器则不须要这一步)。
而后咱们经过route()取出了建立carousel的页面。
断言响应的HTTP状态码为200。
最后断言会在页面上看到的文本值。

运行phpunit看看会发生什么。架构

PHPUnit 6.5.7 by Sebastian Bergmann and contributors.
E                                                                   1 / 1 (100%)
Time: 920 ms, Memory: 26.00MB
There was 1 error:
1) Tests\Feature\Admin\Carousels\CarouselFeatureTest::it_can_show_the_create_carousel_page
InvalidArgumentException: Route [admin.carousel.create] not defined.

出错就对了。咱们尚未在web.php这个路由文件中定义路由，因此将会出现上面的错误。让咱们定义这个路由。app

<?php
Route::namespace('Admin')->group(function () {
    Route::resource('carousel', 'Carousels\CarouselController');
});

分析：

在个人app/Http/Controllers目录中还有其余目录归置文件和文件夹。我有Admin, Front 和 Auth这几个目录。
在Admin这个命名空间中还有Carousels文件夹，在这个文件夹中是CarouselController.php文件。

在终端中运行中运行以下命令来建立控制器

php artisan make:controller --resource Admin/Carousels/CarouselController

定义路由、建立好Controller以后，再次运行phpunit

PHPUnit 6.5.7 by Sebastian Bergmann and contributors.
F                                                                   1 / 1 (100%)
Time: 987 ms, Memory: 28.00MB
There was 1 failure:
1) Tests\Feature\Admin\Carousels\CarouselFeatureTest::it_can_show_the_create_carousel_page
Failed asserting that '' contains "Title".

起做用了！路由错误消失了不过咱们遇到了一个新的错误，经过新错误让咱们想到应该是测试用例服务在响应的UI页面上找到Title这个单词。Hmm 好吧，这是应为咱们没有在create方法中返回视图，让咱们加上返回视图的代码。

<?php
namespace App\Http\Controllers\Admin\Carousels;
use App\Http\Controllers\Controller;
class CarouselController extends Controller
{
    /**
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public function create()
    {
        return view('admin.carousels.create');
    }
}

视图文件位于resource/views/admin/carousels/create.blade.php

@extends('layouts.admin.app')

@section('content')
    <!-- Main content -->
    <section class="content">
        @include('layouts.errors-and-messages')
        <div class="box">
            <div class="box-body">
                <form action="{{ route('admin.carousel.store') }}" method="post" enctype="multipart/form-data">
                    {{ csrf_field() }}
                    <div class="form-group">
                        <label for="title">Title</label>
                        <input type="text" name="title" id="title" class="form-control" placeholder="Title" value="{{ old('title') }}">
                    </div>
                    <div class="form-group">
                        <label for="image">Image</label>
                        <input type="file" name="image" id="image" class="form-control">
                    </div>
                    <div class="form-group">
                        <label for="link">Link</label>
                        <div class="input-group">
                            <span class="input-group-addon">http://</span>
                            <input type="text" name="link" id="link" class="form-control" placeholder="www.example.com" value="{{ old('link') }}">
                        </div>
                    </div>
                    <div class="btn-group">
                        <a href="{{ route('admin.carousel.index') }}" class="btn btn-default btn-sm">Back</a>
                        <button type="submit" class="btn btn-primary btn-sm">Create</button>
                    </div>
                </form>
            </div>
        </div>
    </section>
    <!-- /.content -->
@endsection

视图文件夹中并无admin和carousels文件夹，因此你须要本身建立它们。

建立好blade视图文件后再次运行phpunit

➜  git: phpunit --filter=CarouselFeatureTest::it_can_show_the_create_carousel_page
PHPUnit 6.5.7 by Sebastian Bergmann and contributors.
.                                                                   1 / 1 (100%)
Time: 810 ms, Memory: 28.00MB
OK (1 test, 6 assertions)

Nice，看起来很是好。

如今，若是有人搞乱了你的blade模板，你会立刻知道由于这个测试会执行失败。到Github里去检查一下究竟是谁搞乱模板文件，蛤！

经过POST数据建立carousel

如今让咱们测试一下经过页面里的表单是否可以建立carousel数据。

要建立carousel别忘了先写测试，没有捷径。

<?php
namespace Tests\Feature\Admin\Carousels;
use Tests\TestCase;
class CarouselFeatureTest extends TestCase
{
    /** @test */
    public function it_can_create_the_carousel()
    {
        $file = UploadedFile::fake()->create('image.jpg');
        $data = [
            'title' => $this->faker->word,
            'link' => $this->faker->url,
            'image' => $file,
        ];
      
        $employee = factory(User::class)->create();
      
        $this
            ->actingAs($employee, 'admin')
            ->post(route('admin.carousel.store'), $data)
            ->assertStatus(302)
            ->assertRedirect(route('admin.carousel.index'))
            ->assertSessionHas('message', 'Create carousel successful!');
    }
  
    /** @test */
    public function it_can_show_the_create_carousel_page()
    {
       $employee = factory(User::class)->create();
        $this
            ->actingAs($employee, 'admin')
            ->get(route('admin.carousel.create'))
            ->assertStatus(200)
            ->assertSee('Title')
            ->assertSee('Subtitle')
            ->assertSee('Link')
            ->assertSee('Link Text')
            ->assertSee('Image');
    }
}

分析：

咱们断言在建立成功后会重定向到carousel列表页。
咱们还断言成功设置了Create carousel successful!这个Flash信息

这个测试会执行失败，由于store()方法如今还空着，让咱们用下面的代码填充它：

<?php
namespace App\Http\Controllers\Admin\Carousels;
use App\Http\Controllers\Controller;
use App\Shop\Carousels\Exceptions\CarouselNotFoundException;
use App\Shop\Carousels\Exceptions\CreateCarouselErrorException;
use App\Shop\Carousels\Exceptions\UpdateCarouselErrorException;
use App\Shop\Carousels\Repositories\CarouselRepository;
use App\Shop\Carousels\Repositories\CarouselRepositoryInterface;
use App\Shop\Carousels\Requests\CreateCarouselRequest;
use App\Shop\Carousels\Requests\UpdateCarouselRequest;
use Illuminate\Http\UploadedFile;
class CarouselController extends Controller
{
    /**
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public function create()
    {
        return view('admin.carousels.create');
    }
    /**
     * @param CreateCarouselRequest $request
     * @return \Illuminate\Http\RedirectResponse
     */
    public function store(CreateCarouselRequest $request)
    {
        try {
          
            $data = $request->except('_token');
            if ($request->hasFile('image') && $request->file('image') instanceof UploadedFile) {
                $data['src'] = $request->file('image')->store('carousels', ['disk' => 'public']);
            }
            
            $carouselRepo = new CarouselRepository(new Carousel);
            $carouselRepo->createCarousel($data);
          
            $request->session()->flash('message', 'Create carousel successful!');
            return redirect()->route('admin.carousel.index');
        } catch (CreateCarouselErrorException $e) {
            $request->session()->flash('error', $e->getMessage());
            return redirect()->back()->withInput();
        }
    }
}

而后运行phpunit

➜  git: phpunit --filter=CarouselFeatureTest::it_can_create_the_carousel          
PHPUnit 6.5.7 by Sebastian Bergmann and contributors.
.                                                                   1 / 1 (100%)
Time: 993 ms, Memory: 28.00MB
OK (1 test, 5 assertions)

在编写其余控制器方法时也像这样写功能测试，准备好出发吧。