Laravel 5.5 数据库 - 填充器

雨点打透心脏的1/2处 2022-05-15 14:39 227阅读 0赞

## 简介 ##

Laravel 使用填充类提供了一个简单方法来填充测试数据到数据库。

所有的填充类都位于 database/seeds 目录。

填充类的类名完全由你自定义，但最好还是遵循一定的规则，例如 UsersTableSeeder 等。

在 Laravel 中，默认会提供一个 DatabaseSeeder 示例类。从这个类中，你可以使用 call 方法来运行其他填充类，从而允许你控制数据的填充顺序。

database/seeds/DatabaseSeeder.php 的默认内容为：

<?php
    
    use Illuminate\Database\Seeder;
    
    class DatabaseSeeder extends Seeder
    {
        /**
         * Run the database seeds.
         *
         * @return void
         */
        public function run()
        {
            // $this->call(UsersTableSeeder::class);
        }
    }

## 创建填充器 ##

要生成一个填充器，可以通过 Artisan 命令 make:seeder。

php artisan make:seeder UsersTableSeeder

会自动生成 database/seeds/UsersTableSeeder.php 填充器：

<?php
    
    use Illuminate\Database\Seeder;
    
    class UsersTableSeeder extends Seeder
    {
        /**
         * Run the database seeds.
         *
         * @return void
         */
        public function run()
        {
            //
        }
    }

填充器类默认只包含一个方法：run。当 Artisan 命令 db:seed 运行时该方法被调用。

在 run 方法中，可以插入任何你想插入数据库的数据，你可以使用查询构建器手动插入数据，也可以使用 Eloquent 模型工厂。

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

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

<?php
    
    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'),
            ]);
        }
    }

### 使用模型工厂 ###

手动指定每一个模型填充的属性是很笨重累赘的，取而代之的，我们可以使用模型工厂来快速生成大量的数据库记录。

首先，查看模型工厂文档来学习如何定义工厂，定义完工厂后，可以使用辅助函数 factory 来插入记录到数据库。

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

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

### 调用其他填充器 ###

在 DatabaseSeeder 类中，你可以使用 call 方法执行其他填充类。

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

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

### 运行填充器 ###

编写好填充器类之后，需要通过 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