[ Laravel 5.4 文档 ] 测试 —— 数据库

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.phpCommentFactory.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;
        }
    ];
});

学院君 has written 848 articles

终身学习者,Laravel学院院长

4 thoughts on “[ Laravel 5.4 文档 ] 测试 —— 数据库

  1. 皮卡丘 says:

    算是心得了 如果使用DatabaseMigrations 最好在专门一个空的数据库中使用 因为一旦你的migration的down方法中写了类似chema::dropIfExists(‘user_info’); 这样的逻辑 就会在测试用例执行完毕时(估计是在用例父类teardown方法中)自动被执行相当 然后你的表就被删除了

  2. 皮卡丘 says:

    我在ModelFactory.php里这样写的:
    $factory->define(App\User\Info::class, function (Faker\Generator $faker) {

    但执行phpunit的时候一直提示Unable to locate factory with name [default] [App\User\Info].
    我在定义factory的代码里加了一些输出代码 但都没有输出
    我怀疑ModelFactory.php并没有被自动加载上
    求解

    1. 皮卡丘 says:

      基本上算解决了 查了一圈 发现之前之所以没有加载database/factories/目录下的文件 可能是因为我写在setup方法里面 而且还是在执行parent::setup上面调用的工厂

      没有去详细看代码 我估计是Tests\TestCase这个类的继承逻辑或trait中的逻辑在setup方法中才会加载 database/factories目录中定义的工厂

发表评论

标记为*的字段是必填项(邮箱地址不会被公开)

你可以使用这些HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>