数据填充


简介

Laravel 使用填充类提供了一个简单方法来填充测试数据到数据库。所有的填充类都位于 database/seeds 目录。填充类的类名完全由你自定义,但最好还是遵循一定的规则,例如 UserSeeder 等。安装完 Laravel 后,默认会提供一个 DatabaseSeeder 示例类。从这个类中,你可以使用 call 方法来运行其他填充类,从而允许你控制填充顺序。

编写填充器

要生成一个填充器,可以通过 Artisan 命令 make:seeder。所有框架生成的填充器都位于 database/seeds 目录:

php artisan make:seeder UserSeeder

一个填充器类默认只包含一个方法:run。当 Artisan 命令 db:seed 运行时该方法被调用。在 run 方法中,可以插入任何你想插入数据库的数据,你可以使用查询构建器手动插入数据,也可以使用 Eloquent 模型工厂(后面数据库测试部分文档会详述这个概念)。

注:数据库填充期间模型批量赋值(后面 Eloquent ORM 中会详述这个概念)自动被禁止。

举个例子,让我们修改 Laravel 安装时自带的 DatabaseSeeder 类,添加一个数据库插入语句到 run 方法:

<?php

namespace Database\Seeders;

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

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

注:你可以在 run 方法签名中对任何需要的依赖进行类型提示,它们会通过服务容器自动解析。

使用模型工厂

当然,手动指定每一个模型填充的属性是很笨重累赘的,取而代之的,我们可以使用模型工厂来快速生成大量的数据库记录。首先,查看模型工厂文档来学习如何定义工厂,定义完工厂后,可以使用辅助函数 factory 来插入记录到数据库。

举个例子,让我们创建 50 个用户并添加关联关系到每个用户:

use App\Models\User;

/**
 * 运行数据库填充器
 *
 * @return void
 */
public function run()
{
    User::factory()
            ->times(50)
            ->hasPosts(1)
            ->create();
}

调用其他填充器

DatabaseSeeder 类中,你可以使用 call 方法执行其他填充类,使用 call 方法允许你将数据库填充分解成多个文件,这样单个填充器类就不会变得无比巨大,只需简单将你想要运行的填充器类名传递过去即可:

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

运行填充器

编写好填充器类之后,需要通过 dump-autoload 命令重新生成 Composer 的自动加载器:

composer dump-autoload

运行之后可以使用 Artisan 命令 db:seed 来填充数据库。默认情况下,db:seed 命令运行 DatabaseSeeder 类,不过,你也可以使用 --class 选项来指定你想要运行的独立的填充器类:

php artisan db:seed
php artisan db:seed --class=UserSeeder

你还可以使用 migrate:refresh 命令来填充数据库,该命令还可以回滚并重新运行所有迁移,这在需要完全重建数据库时很有用:

php artisan migrate:refresh --seed

在生产环境强制运行填充器

有些填充操作可能会导致数据变更或丢失。为了防止在生产数据库运行填充命令,在填充器执行前,你会被提示以便确认是否执行。如果你确实想要执行这些填充器而不被提示打断,可以在运行填充命令时带上 --force 标记:

php artisan db:seed --force

实例教程


Vote Vote Cancel Collect Collect Cancel

<< 上一篇: 迁移

>> 下一篇: Redis