数据填充 - Laravel 5.7 中文文档 - 文档

简介

Laravel 包含一个使用填充类为数据库填充测试数据的简单方法。所有填充类都存储在 database/seeds 目录中。填充类可以使用任何您希望的名称，但是可能要遵守一些合理的约定，例如 UsersTableSeeder 等。默认情况下，为您定义了一个 DatabaseSeeder 类。在此类中，可以使用 call 方法调用其它填充类，并控制填充顺序。

编写 Seeders

生成 Seeder，可以执行 Artisan 命令 make:seeder。框架生成的所有 Seeder 都放在 database/seeds 目录中：

php artisan make:seeder UsersTableSeeder

Seeder 类默认只包含一个方法：run。此方法在执行 Artisan 命令 db:seed 时调用。在 run 方法中，可以把任何希望的数据插入到数据库中。可以使用查询构造器手动插入数据或者使用 Eloquent 模型工厂。

数据库数据填充时，会自动禁用批量赋值保护。

例如，我们修改默认的 DatabaseSeeder 类并在 run 方法中添加一条数据库插入语句：

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class DatabaseSeeder extends Seeder
{
    /**
     * 运行数据库数据填充
     *
     * @return void
     */
    public function run()
    {
        DB::table('users')->insert([
            'name' => str_random(10),
            'email' => str_random(10).'@gmail.com',
            'password' => bcrypt('secret'),
        ]);
    }
}

可以在 run 方法的参数中对任何所需依赖使用类型提示。它们会自动通过 Laravel 的服务容器解析。

使用模型工厂

当然，手动为每个模型填充指定属性很麻烦。作为替代方案，可以使用模型工厂方便地生成大量数据库记录。首先，查看模型工厂文档了解如何定义工厂。定义工厂后，可以使用 factory 辅助函数插入记录到数据库中。

例如，我们创建 50 个用户并为每个用户附加一个关联：

/**
 * 运行数据库数据填充
 *
 * @return void
 */
public function run()
{
    factory(App\User::class, 50)->create()->each(function ($u) {
        $u->posts()->save(factory(App\Post::class)->make());
    });
}

调用其它 Seeders

在 DatabaseSeeder 类中，可以使用 call 方法执行其它填充类。使用 call 方法允许您将数据库填充分散到多个文件中，防止单个 Seeder 类变得过大。传递希望运行的填充类即可：

/**
 * 运行数据库数据填充
 *
 * @return void
 */
public function run()
{
    $this->call([
        UsersTableSeeder::class,
        PostsTableSeeder::class,
        CommentsTableSeeder::class,
    ]);
}

运行 Seeders

编写 Seeder 后，可能需要使用 dump-autoload 命令重新生成 Composer 的自动加载类：

composer dump-autoload

现在可以使用 Artisan 命令 db:seed 填充数据库了。默认情况下，db:seed 命令会运行 DatabaseSeeder 类，此类可用于调用其它填充类。不过，也可以使用 --class 选项指定填充类单独运行：

php artisan db:seed

php artisan db:seed --class=UsersTableSeeder

也可以使用 migrate:refresh 命令填充数据库，回滚并重新运行所有迁移。此命令在完全重建数据库时很有用：

php artisan migrate:refresh --seed