[TOC]
### **1、简介**
[Laravel](http://laravelacademy.org/tags/laravel "View all posts in Laravel") 植根于[测试](http://laravelacademy.org/tags/%e6%b5%8b%e8%af%95 "View all posts in 测试")，实际上，内置使用[PHPUnit](https://phpunit.de/)对测试提供支持是即开即用的，并且`phpunit.xml`文件已经为应用设置好了。框架还提供了方便的辅助方法允许你对应用进行富有表现力的测试。
`tests` 目录中提供了一个 `ExampleTest.php` 文件，安装完新的 Laravel 应用后，只需简单在命令行运行`phpunit`来运行测试。
#### **1.1 测试环境**
运行测试的时候，Laravel 自动设置配置环境为 `testing`。Laravel在测试时自动配置 session 和 cache 驱动为数组驱动，这意味着测试时不会持久化存储 session 和 cache。
如果需要的话你也可以创建其它测试环境配置。`testing` 环境变量可以在 `phpunit.xml` 文件中配置。
#### **1.2 定义&运行测试**
要创建一个新的测试用例，可以使用如下Artisan命令：
~~~
php artisan make:test UserTest
~~~
该命令将会在 `tests` 目录下生成一个新的 `UserTest` 类。然后你可以使用 [PHPUnit](http://laravelacademy.org/tags/phpunit "View all posts in PHPUnit") 定义测试方法。要运行测试，简单从终端执行 `phpunit` 命令即可：
~~~
<?php
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class UserTest extends TestCase{
/**
* A basic test example.
*
* @return void
*/
public function testExample()
{
$this->assertTrue(true);
}
}
~~~
> 注意：如果你在测试类中定义自己的 `setUp` 方法，确保在其中调用 `parent::setUp`。
### **2、应用测试**
Laravel 为生成 HTTP [请求](http://laravelacademy.org/tags/%e8%af%b7%e6%b1%82 "View all posts in 请求")、测试输出、以及填充[表单](http://laravelacademy.org/tags/%e8%a1%a8%e5%8d%95 "View all posts in 表单")提供了平滑的API。举个例子，我们看下 `tests` 目录下包含的`ExampleTest.php`文件：
~~~
<?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` 方法对我们从应用返回响应中应该看到的给定文本进行[断言](http://laravelacademy.org/tags/%e6%96%ad%e8%a8%80 "View all posts in 断言")。`dontSee` 方法对给定文本没有从应用响应中返回进行断言。在Laravel中这是最基本的有效应用测试。
#### **2.1 与应用交互**
当然，除了对响应文本进行断言之外还有做更多测试，让我们看一些点击链接和填充表单的例子：
##### **点击链接**
在本测试中，我们将为应用生成请求，在返回的响应中“点击”链接，然后对访问URI进行断言。例如，假定响应中有一个“关于我们”的链接：
~~~
<a href="/about-us">About Us</a>
~~~
现在，让我们编写一个测试点击链接并断言用户访问页面是否正确：
~~~
public function testBasicExample(){
$this->visit('/')
->click('About Us')
->seePageIs('/about-us');
}
~~~
##### **处理表单**
Laravel 还为处理表单提供了多个方法。`type`, `select`, `check`, `attach`, 和`press`方法允许你与所有表单输入进行交互。例如，我们假设这个表单存在于应用注册页面：
~~~
<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->attach($pathToFile, $elementName)` | “Attach” 文件到表单 |
| `$this->press($buttonTextOrElementName)` | “Press” 给定文本或name的按钮 |
| `$this->uncheck($elementName)` | “Uncheck”复选框 |
##### **处理附件**
如果表单包含`file`输入类型，可以使用`attach`方法添加文件到表单：
~~~
public function testPhotoCanBeUploaded(){
$this->visit('/upload')
->name('File Name', 'name')
->attach($absolutePathToFile, 'photo')
->press('Upload')
->see('Upload Successful!');
}
~~~
#### **2.2 测试[JSON](http://laravelacademy.org/tags/json "View all posts in JSON") API**
Laravel 还提供多个帮助函数用于测试 JSON API 及其响应。例如，`get`, `post`, `put`, `patch`, 和 `delete`方法用于通过多种 HTTP 请求方式发出请求。你还可以轻松传递数据和头到这些方法。作为开始，我们编写测试来生成 POST 请求到 `/user` 并断言返回的数据是否是 JSON 格式：
~~~
<?php
class ExampleTest extends TestCase{
/**
* 基本功能测试示例
*
* @return void
*/
public function testBasicExample()
{
$this->post('/user', ['name' => 'Sally'])
->seeJson([
'created' => true,
]);
}
}
~~~
`seeJson` 方法将给定数组转化为 JSON，然后验证应用返回的整个 JSON 响应中的 JSON 片段。因此，如果在 JSON 响应中有其他属性，只要给定片段存在的话测试依然会通过。
##### **验证JSON值匹配**
如果你想要验证给定数组和应用返回的JSON能够精确匹配，使用 `seeJsonEquals` 方法：
~~~
<?php
class ExampleTest extends TestCase{
/**
* 基本功能测试示例
*
* @return void
*/
public function testBasicExample()
{
$this->post('/user', ['name' => 'Sally'])
->seeJsonEquals([
'created' => true,
]);
}
}
~~~
##### **验证JSON数据结构匹配**
还可以验证JSON响应是否与指定数据结构匹配，我们使用 `seeJsonStructure` 方法来实现这一功能：
~~~
<?php
class ExampleTest extends TestCase{
/**
* A basic functional test example.
*
* @return void
*/
public function testBasicExample()
{
$this->get('/user/1')
->seeJsonStructure([
'name',
'pet' => [
'name', 'age'
]
]);
}
}
~~~
上面的例子演示了期望获取一个包含 `name` 和嵌套 `pet` 对象（该对象包含 `name` 和 `age` 属性）的 JSON 数据。如果 JSON 响应中包含其它额外键 `seeJsonStructure` 也不会失败，例如，如果 `pet` 对象包含 `weight` 属性测试仍将通过。
你可以使用*来断言返回JSON结构包含一个列表，该列表中的每个数据项都包含至少如下示例中列出的属性：
~~~
<?php
class ExampleTest extends TestCase{
/**
* A basic functional test example.
*
* @return void
*/
public function testBasicExample()
{
// Assert that each user in the list has at least an id, name and email attribute.
$this->get('/users')
->seeJsonStructure([
'*' => [
'id', 'name', 'email'
]
]);
}
}
~~~
你还可以使用嵌套的*，在这种场景中，我们可以断言JSON响应中的每个用户都包含一个给定属性集合，而且每个用户的每个 `pet` 都包含给定属性集合：
~~~
$this->get('/users')
->seeJsonStructure([
'*' => [
'id', 'name', 'email', `pets` => [
'*' => [
'name', 'age'
]
]
]
]);
~~~
#### **2.3 Session/[认证](http://laravelacademy.org/tags/%e8%ae%a4%e8%af%81 "View all posts in 认证")**
Laravel提供了多个辅助函数用于在测试期间处理[Session](http://laravelacademy.org/post/3261.html)，首先，可以使用`withSession`方法设置 session 值到给定数组。这在测试请求前获取 session 数据时很有用：
~~~
<?php
class ExampleTest extends TestCase{
public function testApplication()
{
$this->withSession(['foo' => 'bar'])
->visit('/');
}
}
~~~
当然，session的通常用于操作用户状态，例如认证用户。辅助函数`actingAs` 提供了认证给定用户为当前用户的简单方法，例如，我们使用[模型工厂](http://laravelacademy.org/post/3274.html#model-factories)生成和认证用户：
~~~
<?php
class ExampleTest extends TestCase{
public function testApplication()
{
$user = factory('App\User')->create();
$this->actingAs($user)
->withSession(['foo' => 'bar'])
->visit('/')
->see('Hello, '.$user->name);
}
}
~~~
还可以通过传递 `guard` 名称作为 `actingAs` 函数的第二个参数的方式来指定使用哪个 `guard` 来认证给定用户：
~~~
$this->actingAs($user, 'backend')
~~~
#### **2.4 禁止中间件**
测试应用时，为某些测试禁止[中间件](http://laravelacademy.org/post/2803.html)很方便。这种机制允许你将路由和控制器与中间件孤立开来做测试，Laravel包含了一个简单的 `WithoutMiddleware` trait，可以使用该 trait 自动在测试类中禁止所有中间件：
~~~
<?php
use Illuminate\Foundation\Testing\WithoutMiddleware;
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');
}
}
~~~
#### **2.5 自定义HTTP请求**
如果你想要在应用中生成自定义HTTP请求并获取完整的 `Illuminate\Http\Response` 对象，可以使用 `call` 方法：
~~~
public function testApplication(){
$response = $this->call('GET', '/');
$this->assertEquals(200, $response->status());
}
~~~
如果你要生成`POST`, `PUT`, 或者 `PATCH`请求可以在请求中传入输入数据数组，在路由或控制器中可以通过[Request实例](http://laravelacademy.org/post/2824.html)访问请求数据：
~~~
$response = $this->call('POST', '/user', ['name' => 'Taylor']);
~~~
#### **2.6 PHPUnit断言方法**
Laravel 为 PHPUnit 测试提供了额外的断言方法：
| 方法 | 描述 |
| --- | --- |
| `->assertResponseOk();` | 断言客户端响应状态码是否为200 |
| `->assertResponseStatus($code);` | 断言客户端响应状态码是否是给定$code |
| `->assertViewHas($key, $value = null);` | 断言响应视图是否包含给定的绑定数据片段 |
| `->assertViewHasAll(array $bindings);` | 断言视图是否包含给定绑定数据列表 |
| `->assertViewMissing($key);` | 断言响应视图缺失绑定数据片段 |
| `->assertRedirectedTo($uri, $with = []);` | 断言客户端是否重定向到给定URI |
| `->assertRedirectedToRoute($name, $parameters = [], $with = []);` | 断言客户端是否重定向到给定路由 |
| `->assertRedirectedToAction($name, $parameters = [], $with = []);` | 断言客户端是否重定向到给定action |
| `->assertSessionHas($key, $value = null);` | 断言session是否包含给定值 |
| `->assertSessionHasAll(array $bindings);` | 断言session是否保护眼给定值列表 |
| `->assertSessionHasErrors($bindings = [], $format = null);` | 断言session是否包含错误绑定 |
| `->assertHasOldInput();` | 断言sessio包含上次输入数据 |
### **3、处理[数据库](http://laravelacademy.org/tags/%e6%95%b0%e6%8d%ae%e5%ba%93 "View all posts in 数据库")**
Laravel还提供了多种有用的工具让测试[数据库](http://laravelacademy.org/post/2942.html)驱动的应用更加简单。首先，你可以使用帮助函数 `seeInDatabase` 来断言数据库中的数据是否和给定数据集合匹配。例如，如果你想要通过 email 值为`sally@example.com`的条件去数据表`users`查询是否存在该记录 ，我们可以这样做：
~~~
public function testDatabase(){
// 调用应用...
$this->seeInDatabase('users', ['email' => 'sally@foo.com']);
}
~~~
当然，`seeInDatabase`方法和其它类似辅助方法都是为了方便起见进行的封装，你也可以使用其它PHPUnit内置的断言方法来进行测试。
#### **3.1 每次测试后重置数据库**
每次测试后重置数据库通常很有用，这样的话上次测试的数据不会影响下一次测试。
##### **使用迁移**
一种方式是每次测试后回滚数据库并在下次测试前重新迁移。Laravel提供了一个简单的`DatabaseMigrations` trait来自动为你处理。在测试类上简单使用该trait如下：
~~~
<?php
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class ExampleTest extends TestCase{
use DatabaseMigrations;
/**
* 基本功能测试示例
*
* @return void
*/
public function testBasicExample()
{
$this->visit('/')
->see('Laravel 5');
}
}
~~~
##### **使用事务**
另一种方式是将每一个测试用例包裹到一个数据库事务中，Laravel提供了方便的 `DatabaseTransactions` trait自动为你处理：
~~~
<?php
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class ExampleTest extends TestCase{
use DatabaseTransactions;
/**
* 基本功能测试示例
*
* @return void
*/
public function testBasicExample()
{
$this->visit('/')
->see('Laravel 5');
}
}
~~~
> 注意：该trait只在事务中封装默认数据库连接。
#### **3.2 [模型工厂](http://laravelacademy.org/tags/%e6%a8%a1%e5%9e%8b%e5%b7%a5%e5%8e%82 "View all posts in 模型工厂")**
测试时，通常需要在执行测试前插入新数据到数据库。在创建测试数据时，Laravel允许你使用“factories”为每个[Eloquent模型](http://laravelacademy.org/post/2995.html)定义默认的属性值集合，而不用手动为每一列指定值。作为开始，我们看一下`database/factories/ModelFactory.php`文件，该文件包含了一个工厂定义：
~~~
$factory->define(App\User::class, function (Faker\Generator $faker) {
return [
'name' => $faker->name,
'email' => $faker->email,
'password' => bcrypt(str_random(10)),
'remember_token' => str_random(10),
];
});
~~~
在闭包中，作为工厂定义，我们返回该模型上所有属性默认测试值。该闭包接收PHP库[Faker](https://github.com/fzaninotto/Faker)实例，从而允许你方便地为测试生成多种类型的随机数据。
当然，你可以添加更多工厂到`ModelFactory.php`文件。
##### **多个工厂类型**
有时候你可能想要为同一个Eloquent模型类生成多个工厂，例如，除了正常用户外可能你想要为“管理员”用户生成一个工厂，你可以使用`defineAs`方法定义这些工厂：
~~~
$factory->defineAs(App\User::class, 'admin', function ($faker) {
return [
'name' => $faker->name,
'email' => $faker->email,
'password' => str_random(10),
'remember_token' => str_random(10),
'admin' => true,
];
});
~~~
你可以使用`raw`方法获取基本属性而不用重复基本用户工厂中的所有属性，获取这些属性后，只需将你要求的额外值增补进去即可：
~~~
$factory->defineAs(App\User::class, 'admin', function ($faker) use ($factory) {
$user = $factory->raw(App\User::class);
return array_merge($user, ['admin' => true]);
});
~~~
##### **在测试中使用工厂**
定义好工厂后，可以在测试或数据库填充文件中通过全局的`factory`方法使用它们来生成模型实例，所以，让我们看一些生成模型的例子，首先，我们使用`make`方法，该方法创建模型但不将其保存到数据库：
~~~
public function testDatabase(){
$user = factory(App\User::class)->make();
// 用户模型测试...
}
~~~
如果你想要覆盖模型的一些默认值，可以传递数组值到`make`方法。只有指定值被替换，其他数据保持不变：
~~~
$user = factory(App\User::class)->make([
'name' => 'Abigail',
]);
~~~
还可以创建多个模型集合或者创建给定类型的集合：
~~~
// 创建3个 App\User 实例...
$users = factory(App\User::class, 3)->make();
// 创建1个 App\User "admin" 实例...
$user = factory(App\User::class, 'admin')->make();
// 创建3个 App\User "admin" 实例...
$users = factory(App\User::class, 'admin', 3)->make();
~~~
##### **持久化工厂模型**
`create`方法不仅能创建模型实例，还可以使用Eloquent的`save`方法将它们保存到数据库：
~~~
public function testDatabase(){
$user = factory(App\User::class)->create();
//用户模型测试...
}
~~~
你仍然可以通过传递数组到`create`方法覆盖模型上的属性：
~~~
$user = factory(App\User::class)->create([
'name' => 'Abigail',
]);
~~~
##### **添加关联关系到模型**
你甚至可以持久化多个模型到数据库。在本例中，我们添加一个关联到创建的模型，使用`create`方法创建多个模型的时候，会返回一个[Eloquent集合](http://laravelacademy.org/post/3031.html)实例，从而允许你使用集合提供的所有便利方法，例如`each`：
~~~
$users = factory(App\User::class, 3)
->create()
->each(function($u) {
$u->posts()->save(factory(App\Post::class)->make());
});
~~~
### **4、[模拟](http://laravelacademy.org/tags/%e6%a8%a1%e6%8b%9f "View all posts in 模拟")**
#### **4.1 模拟事件**
如果你在重度使用Laravel的时间系统，可能想要在测试时模拟特定[事件](http://laravelacademy.org/post/3162.html)。例如，如果你在测试用户注册，你可能不想所有`UserRegistered`的时间处理器都被触发，因为这可能会发送欢迎邮件，等等。
Laravel提供可一个方便的`expectsEvents`方法来验证期望的事件被触发，但同时阻止该事件的其它处理器运行：
~~~
<?php
class ExampleTest extends TestCase{
public function testUserRegistration()
{
$this->expectsEvents(App\Events\UserRegistered::class);
// 测试用户注册代码...
}
}
~~~
可以使用`doesntExpectEvents`方法来验证给定事件没有被触发：
~~~
<?php
class ExampleTest extends TestCase{
public function testPodcastPurchase()
{
$this->expectsEvents(App\Events\PodcastWasPurchased::class);
$this->doesntExpectEvents(App\Events\PaymentWasDeclined::class);
// Test purchasing podcast...
}
}
~~~
如果你想要阻止所有事件运行，可以使用`withoutEvents`方法：
~~~
<?php
class ExampleTest extends TestCase{
public function testUserRegistration()
{
$this->withoutEvents();
// 测试用户注册代码...
}
}
~~~
#### **4.2 模拟[队列任务](http://laravelacademy.org/post/3252.html)**
有时候，你可能想要在请求时简单测试控制器分发的指定任务，这允许你孤立的测试路由/控制器——将其从任务逻辑中分离出去，当然，接下来你可以在一个独立测试类中测试任务本身。
Laravel提供了一个方便的`expectsJobs`方法来验证期望的任务被分发，但该任务本身不会被测试：
~~~
<?php
class ExampleTest extends TestCase{
public function testPurchasePodcast()
{
$this->expectsJobs(App\Jobs\PurchasePodcast::class);
// 测试购买播客代码...
}
}
~~~
> 注意：这个方法只检查通过`DispatchesJobs` trait分发方法分发的任务，并不检查直接通过`Queue::push`分发的任务。
#### **4.3 模拟门面**
测试的时候，你可能经常想要模拟[Laravel门面](http://laravelacademy.org/post/2920.html)的调用，例如，看看下面的控制器动作：
~~~
<?php
namespace App\Http\Controllers;
use Cache;
use Illuminate\Routing\Controller;
class UserController extends Controller{
/**
* 显示应用用户列表
*
* @return Response
*/
public function index()
{
$value = Cache::get('key');
//
}
}
~~~
我们可以通过使用`shouldReceive`方法模拟`Cache`门面的调用，该方法返回一个[Mockery](https://github.com/padraic/mockery)模拟的实例，由于门面通过Laravel[服务容器](http://laravelacademy.org/post/2910.html)解析和管理，它们比通常的静态类更具有可测试性。例如，我们来模拟`Cache`门面的调用：
~~~
<?php
class FooTest extends TestCase{
public function testGetIndex()
{
Cache::shouldReceive('get')
->once()
->with('key')
->andReturn('value');
$this->visit('/users')->see('value');
}
}
~~~
> 注意：不要模拟`Request`门面，取而代之地，在测试时传递输入到HTTP帮助函数如`call`和`post`。
- 序言
- 发行版本说明
- 升级指南
- 贡献代码
- 开始
- 安装
- 配置
- Laravel Homestead
- 基础
- HTTP 路由
- HTTP 中间件
- HTTP 控制器
- HTTP 请求
- HTTP 响应
- 视图
- Blade 模板引擎
- 架构
- 一次请求的生命周期
- 应用目录结构
- 服务提供者
- 服务容器
- 门面（Facades）
- 数据库
- 起步
- 查询构建器
- 迁移
- 填充数据
- Eloquent ORM
- 起步
- 关联关系
- 集合
- 访问器&修改器
- 序列化
- 服务
- 用户认证
- 用户授权
- Artisan Console
- 订阅支付实现：Laravel Cashier
- 缓存
- 集合
- 集成前端资源：Laravel Elixir
- 加密
- 错误&日志
- 事件
- 文件系统/云存储
- 哈希
- 辅助函数
- 本地化
- 邮件
- 包开发
- 分页
- Redis
- 队列
- Session
- Envoy Task Runner
- 任务调度
- 测试
- 验证
- 新手入门指南
- 简单任务管理系统
- 带用户功能的任务管理系统