* * * * *
[TOC]
## 简介
Laravel提供了各种有用的工具，以便更容易地测试数据库驱动的应用程序。 首先， 你可以使用 `assertDatabaseHas`辅助函数， 来断言数据库中是否存在与指定条件互相匹配的数据。 例如，如果我们想验证 `users` 数据表中是否存在 `email` 值为 `sally@example.com`的数据, 你可以按照以下方式来测试：
~~~
public function testDatabase()
{
// 创建调用至应用程序...
$this->assertDatabaseHas('users', [
'email' => 'sally@example.com'
]);
}
~~~
你也可以使用 `assertDatabaseMissing` 辅助函数来断言数据不在此数据库中。
当然，使用 `assertDatabaseHas` 方法和其它辅助函数只是为了方便。 你也可以随意使用PHPUnit内置的断言方法来扩充测试。
## 生成模型工厂
创建一个模型工厂, 使用 Artisan 命令 `make:factory` 来快速创建模型工厂：
~~~
php artisan make:factory PostFactory
~~~
这个新的模型工厂将被放置在 `database/factories` 目录中。
`--model` 选项可用于指定当模型工厂被创建时生成模型的名称。这个选项将用给定的模型预填充生成的模型工厂文件 ：
~~~
php artisan make:factory PostFactory --model=Post
~~~
## 每次测试后重置数据库
每次测试后重置数据库是很有用的，这样以前测试的数据不会干扰后续的测试。 `RefreshDatabase` trait 会采用最优的方法来迁移你的数据库，这取决于你使用的是内存数据库还是传统数据库。在你的测试类引用这个trait，一切将为你处理：
~~~
<?php
namespace Tests\Feature;
use Tests\TestCase;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
class ExampleTest extends TestCase
{
use RefreshDatabase;
/**
* 一个基本功能测试示例
*
* @return void
*/
public function testBasicExample()
{
$response = $this->get('/');
// ...
}
}
~~~
## 创建模型工厂
测试时，在运行测试之前常常需要插入一些数据到数据库中。当你创建测试数据时，除了手动设置每个字段的值，Laravel还可以使用 [Eloquent模型](https://www.kancloud.cn/tonyyu/laravel_5_6/786272)的工厂来设置每个属性的默认值。在开始之前， 你可以先看一下应用程序 `database/factories/UserFactory.php` 的文件。 开箱即用，这个文件包含一个模型工厂定义：
~~~
use Faker\Generator as Faker;
$factory->define(App\User::class, function (Faker $faker) {
return [
'name' => $faker->name,
'email' => $faker->unique()->safeEmail,
'password' => '$2y$10$TKh8H1.PfQx37YgCzwiKb.KjNyWgaHb9cbcoQgdIVFlYg7B77UdFm', // secret
'remember_token' => str_random(10),
];
});
~~~
在这个模型工厂定义的闭包中，你可以返回模型上所有属性的默认测试值。闭包将接受 PHP 函数库 [Faker](https://github.com/fzaninotto/Faker) 的一个实例，它允许你便捷的生成各种随机数据来进行测试。
你也可以为每个模型创建一个工厂文件以实现更好的组织。 例如，你可以自`database/factories` 目录下创建 `UserFactory.php` 和`CommentFactory.php` 文件。 Laravel将自动加载 `factories` 目录下的所有文件。
> {tip} 你也可以在 `config/app.php` 配置文件中添加 `faker_locale` 选项来设置 Faker 的语言环境。
### 工厂状态
工厂状态可以让你任意组合你的模型工厂，仅需要做出适当差异化的修改，就可以达到让模型拥有多种不同的状态。例如， 你的 `User` 模型中可以修改某个默认属性值来达到标识一种 `delinquent` 状态。你可以使用 `state` 方法来进行这种状态转换。对于简单的工厂状态，你可以传入要修改的属性数组：
~~~
$factory->state(App\User::class, 'delinquent', [
'account_status' => 'delinquent',
]);
~~~
如果你的工厂状态需要计算或者使用 `$faker` 实例。你可以使用闭包方法来实现状态属性的修改：
~~~
$factory->state(App\User::class, 'address', function ($faker) {
return [
'address' => $faker->address,
];
});
~~~
## 使用模型工厂
### 创建模型
模型工厂定义后，就可以在测试或者是数据库的填充文件中，通过全局的 `factory` 函数来生成模型实例。因此，先让我们来看看几个模型创建的例子。 首先，我们将使用 `make` 方法创建模型但不将他们保存至数据库：
~~~
public function testDatabase()
{
$user = factory(App\User::class)->make();
// 在测试中使用模型...
}
~~~
你也可以创建一个含有多个模型的集合，或创建一个指定类型的模型：
~~~
// 创建三个 App\User 实例...
$users = factory(App\User::class, 3)->make();
~~~
#### 应用模型工厂状态
你可能需要在你的模型中应用不同的 [模型工厂状态](https://www.kancloud.cn/tonyyu/laravel_5_6/786284#_91) 。 如果你想模型加上多种不同的状态，你只需指定每个你想要添加状态的名称就可以了：
~~~
$users = factory(App\User::class, 5)->states('delinquent')->make();
$users = factory(App\User::class, 5)->states('premium', 'delinquent')->make();
~~~
### 使用回调
你可以使用 `afterMaking` 和 `afterCreating` 两个方法来注册模型工厂回调。示例代码如下：
~~~
$factory->afterMaking(App\User::class, function ($user, $faker) {
// ...
});
$factory->afterCreating(App\User::class, function ($user, $faker) {
$user->accounts()->save(factory(App\Account::class)->make());
});
~~~
你可以可以为 [模型工厂状态](https://www.kancloud.cn/tonyyu/laravel_5_6/786284#_91) 定义回调：
~~~
$factory->afterMakingState(App\User::class, 'delinquent', function ($user, $faker) {
// ...
});
$factory->afterCreatingState(App\User::class, 'delinquent', function ($user, $faker) {
// ...
});
~~~
#### 重写模型属性
通过给 `make` 方法传入一个数组，可以重写模型的默认属性值。这样仅替换指定的属性，其他的属性还是由模型工厂默认填充：
~~~
$user = factory(App\User::class)->make([
'name' => 'Abigail',
]);
~~~
### 模型持久化
`create` 方法创建模型实例的同时还调用了把记录写入数据库的 `save` 方法：
~~~
public function testDatabase()
{
// 创建单个 App\User 实例
$user = factory(App\User::class)->create();
// 创建三个 App\User 实例
$users = factory(App\User::class, 3)->create();
// 在测试中使用模型
}
~~~
传一个数组给 `create` 方法重写模型的属性：
~~~
$user = factory(App\User::class)->create([
'name' => 'Abigail',
]);
~~~
### 关联
这个例子，将为模型添加关联。`create` 方法创建多模型时，返回 Eloquent [实例集合](https://www.kancloud.cn/tonyyu/laravel_5_6/786274)，这样就可以在集合上使用 `each` 等便利方法：
~~~
$users = factory(App\User::class, 3)
->create()
->each(function ($u) {
$u->posts()->save(factory(App\Post::class)->make());
});
~~~
#### 关联 & 属性闭包
模型工厂定义时，也可以使用闭包里的属性来给模型添加关联。比如，创建 `Post` 实例时，同时创建 `User` 实例，就可以这样做：
~~~
$factory->define(App\Post::class, function ($faker) {
return [
'title' => $faker->title,
'content' => $faker->paragraph,
'user_id' => function () {
return factory(App\User::class)->create()->id;
}
];
});
~~~
这些闭包接收一个包含工厂属性的数组：
~~~
$factory->define(App\Post::class, function ($faker) {
return [
'title' => $faker->title,
'content' => $faker->paragraph,
'user_id' => function () {
return factory(App\User::class)->create()->id;
},
'user_type' => function (array $post) {
return App\User::find($post['user_id'])->type;
}
];
});
~~~
## 可用的断言方法
Laravel 为 [PHPUnit](https://phpunit.de/) 测试提供了多个数据库断言方法：
| 方法 | 描述 |
| --- | --- |
| `$this->assertDatabaseHas($table, array $data);` | 断言数据库表中含有指定数据。 |
| `$this->assertDatabaseMissing($table, array $data);` | 断言数据库表中不含有指定数据。 |
| `$this->assertSoftDeleted($table, array $data);` | 断言数据库中的指定记录已软删除。 |
- 前言
- 翻译说明
- 发行说明
- 升级指南
- 贡献导引
- 入门指南
- 安装
- 配置信息
- 文件夹结构
- Homestead
- Valet
- 部署
- 核心架构
- 请求周期
- 服务容器
- 服务提供者
- Facades
- Contracts
- 基础功能
- 路由
- 中间件
- CSRF 保护
- 控制器
- 请求
- 响应
- 视图
- URL
- Session
- 表单验证
- 错误
- 日志
- 前端开发
- Blade 模板
- 本地化
- 前端指南
- 编辑资源 Mix
- 安全相关
- 用户认证
- Passport OAuth 认证
- 用户授权
- 加密解密
- 哈希
- 重置密码
- 综合话题
- Artisan 命令行
- 广播系统
- 缓存系统
- 集合
- 事件系统
- 文件存储
- 辅助函数
- 邮件发送
- 消息通知
- 扩展包开发
- 队列
- 任务调度
- 数据库
- 快速入门
- 查询构造器
- 分页
- 数据库迁移
- 数据填充
- Redis
- Eloquent ORM
- 快速入门
- 模型关联
- Eloquent 集合
- 修改器
- API 资源
- 序列化
- 测试相关
- 快速入门
- HTTP 测试
- 浏览器测试 Dusk
- 数据库测试
- 测试模拟器
- 官方扩展包
- Cashier 交易工具包
- Envoy 部署工具
- Horizon
- Scout 全文搜索
- Socialite 社会化登录