数据库
1、简介
Laravel 提供了多个有用的工具让测试数据库驱动的应用变得更加简单。首先,你可以使用辅助函数 assertDatabaseHas
来断言数据库中的数据是否和给定数据集合匹配。例如,如果你想要通过 email
值为sally@example.com
的条件去数据表users
查询是否存在该记录 ,我们可以这样做:
public function testDatabase()
{
// Make call to application...
$this->assertDatabaseHas('users', [
'email' => 'sally@example.com'
]);
}
当然,assertDatabaseHas
方法和其它类似辅助方法都是为了方便起见进行的封装,你也可以使用其它 PHPUnit 内置的断言方法来进行测试。
2、每次测试后重置数据库
每次测试后重置数据库通常很有用,这样的话上次测试的数据不会影响下一次测试。
使用迁移
一种重置数据库状态的方式是每次测试后回滚数据库并在下次测试前重新迁移。Laravel 提供了一个简单的 DatabaseMigrations
trait 来自动为你处理。在测试类上简单使用该 trait 如下:
<?php
namespace Tests\Feature;
use Tests\TestCase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class ExampleTest extends TestCase
{
use DatabaseMigrations;
/**
* A basic functional test example.
*
* @return void
*/
public function testBasicExample()
{
$response = $this->get('/');
// ...
}
}
使用事务
另一种重置数据库状态的方式是将每一个测试用例封装到一个数据库事务中,Laravel 提供了方便的 DatabaseTransactions
trait 自动为你处理:
<?php
namespace Tests\Feature;
use Tests\TestCase;
use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
class ExampleTest extends TestCase
{
use DatabaseTransactions;
/**
* A basic functional test example.
*
* @return void
*/
public function testBasicExample()
{
$response = $this->get('/');
// ...
}
}
注:该 trait 只在事务中封装默认数据库连接。如果你的应用使用了多个数据库连接,需要在测试类上定义一个 $connectionsToTransact
属性。该属性应该是用于执行事务的连接名数组。
3、编写工厂
测试时,通常需要在执行测试前插入新数据到数据库。在创建测试数据时,Laravel 允许你使用模型工厂为每个 Eloquent 模型定义默认的属性值集合,而不用手动为每一列指定值。作为开始,我们看一下database/factories/ModelFactory.php
文件,该文件包含了一个工厂定义:
$factory->define(App\User::class, function (Faker\Generator $faker) {
static $password;
return [
'name' => $faker->name,
'email' => $faker->unique()->safeEmail,
'password' => $password ?: $password = bcrypt('secret'),
'remember_token' => str_random(10),
];
});
在闭包中,作为工厂定义,我们返回该模型上所有属性默认测试值。该闭包接收 PHP 库 Faker 实例,从而允许你方便地为测试生成多种类型的随机数据。
当然,你可以添加更多工厂到ModelFactory.php
文件。你还可以为每个模型创建额外的工厂文件以便更好地组织管理,例如,你可以在 database/factories
目录下创建 UserFactory.php
和 CommentFactory.php
文件。 factories
目录下的所有文件都会被Laravel 自动加载。
工厂状态
状态允许你在任意组合中定义可用于模型工厂的离散修改,例如, User
模型可能有一个 delinquent
状态用于修改某个默认属性值,你可以使用 state
方法来定义状态转化:
$factory->state(App\User::class, 'delinquent', function ($faker) {
return [
'account_status' => 'delinquent',
];
});
4、使用工厂
创建模型
定义好工厂后,可以在测试或数据库填充文件中通过全局的 factory
方法使用它们来生成模型实例,所以,让我们看一些创建模型的例子,首先,我们使用 make
方法,该方法创建模型但不将其保存到数据库:
public function testDatabase(){
$user = factory(App\User::class)->make();
// 用户模型测试...
}
还可以创建多个模型集合或者创建给定类型的模型:
// 创建3个 App\User 实例...
$users = factory(App\User::class, 3)->make();
应用状态
还可以应用任意状态到模型,如果你想要应用多个状态转化到模型,需要指定每个你想要应用的状态名:
$users = factory(App\User::class, 5)->states('deliquent')->make();
$users = factory(App\User::class, 5)->states('premium', 'deliquent')->make();
覆盖属性
如果你想要覆盖模型中的某些默认值,可以传递数组值到 make
方法,只有指定值才会被替换,剩下值保持工厂指定的默认值不变:
$user = factory(App\User::class)->make([
'name' => 'Abigail',
]);
持久化模型
create
方法不仅能创建模型实例,还可以使用 Eloquent 的 save
方法将它们保存到数据库:
public function testDatabase()
{
// 创建单个 App\User 实例...
$user = factory(App\User::class)->create();
// 创建3个 App\User 实例...
$users = factory(App\User::class, 3)->create();
// 在测试中使用模型...
}
你可以通过传递数组到 create
方法覆盖模型上的属性:
$user = factory(App\User::class)->create([
'name' => 'Abigail',
]);
关联关系
在本例中,我们添加一个关联到创建的模型,使用 create
方法创建多个模型的时候,会返回一个 Eloquent 集合实例,从而允许你使用集合提供的所有方法,例如 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;
}
];
});
4 Comments