Laravel的功能测试：测试驱动开发（附代码）

时间：2018-08-08 14:17

本篇文章给大家带来的内容是关于Laravel的功能测试：测试驱动开发（附代码），有一定的参考价值，有需要的朋友可以参考一下，希望对你有所帮助。

创建carousel功能测试

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

现在让我们专注于管理后台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');
    }
}

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

我们需要->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这个路由文件中定义路由，所以将会出现上面的错误。让我们定义这个路由。

<?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')
        <p class="box">
            <p class="box-body">
                <form action="{{ route('admin.carousel.store') }}" method="post" enctype="multipart/form-data">
                    {{ csrf_field() }}
                    <p class="form-group">
                        <label for="title">Title</label>
                        <input type="text" name="title" id="title" class="form-control" placeholder="Title" value="{{ old('title') }}">
                    </p>
                    <p class="form-group">
                        <label for="image">Image</label>
                        <input type="file" name="image" id="image" class="form-control">
                    </p>
                    <p class="form-group">
                        <label for="link">Link</label>
                        <p 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') }}">
                        </p>
                    </p>
                    <p 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>
                    </p>
                </form>
            </p>
        </p>
    </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)

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