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)

在編寫其餘控制器方法時也像這樣寫功能測試，準備好出發吧。