laravel 基础教程 —— Seeding

数据库：数据填充（Seeding）

简介

Laravel 使用 seed 类提供一种简便的方法填充你用于测试的数据。所有的 seed 类文件都被存储在 database/seeds 目录下。Seed 类可以拥有任意的类名，但是你应该遵循某些命名规范，比如 UsersTableSeeder，等等。默认的 Laravel 为你提供了 DatabaseSeeder 类，在这个类中，你可以使用 call 方法来调用其他的 seed 类，这为你顺序的进行数据填充提供了便利。

编写 Seeders

你可以使用 make:seeder Artisan 命令来生成一个 seeder。所有通过框架生成的 seeders 都会被放在 database/seeds 目录下：

php artisan make:seeder UsersTableSeeder

seeder 类中默认的只包含了一个方法：run。该方法会在 db:seed Artisan 命令执行时被调用。在 run 方法中，你可以填充任意你想填充的数据到数据库中，你可以使用查询生成器手动的插入数据，或者你也可以使用 Eloquent 模型工厂。

让我们来做个示例，我们修改 Laravel 默认提供的 DatabaseSeeder 类，让我们在 run 方法中进行一些数据插入：

insert([
       'name' => str_random(10),
       'email' => str_random(10).'@gmail.com',
       'password' => bcrypt('secret'),
     ]);
   }
}

使用模型工厂

当然，手动的为每个模型 seed 指定属性是一件非常麻烦的事情。你可以使用 model factories 来方便的生成大量的数据记录。首先，你需要查询一下 model factory documentation 来学习一下如何定义你的模型工厂。一旦你定义了模型工厂，你就可以使用 factory 帮助方法来插入数据到库中。

比如，让我们创建 50 个用户并且为每个用户附加一个关系：

/**
 * Run the database seeds.
 *
 * @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 方法来执行其他的 seed 类。使用 call 方法允许你将数据库填充分解到多个文件中，这样不会使一个单独的 seed 文件过于庞大。你只需要简单的传递 seeder 的类名到方法中就可以进行调用：

/**
 * Run the database seeds.
 *
 * @return void
 */
 public function run()
 {
   $this->call(UsersTableSeeder::class);
   $this->call(PostsTableSeeder::class);
   $this->call(CommentsTableSeeder::class);
 }

执行 Seeders

一旦你编写完成 seeder 类，你就可以使用 db:seed Artisan 命令来将数据填充到数据库中。默认的，db:seed 命令会直接执行 DatabaseSeeder 类，你也可以在这个类中调用其他的 seed 类。事实上，你也可以使用 --class 选项来指定需要填充的类：

php artisan db:seed

php artisan db:seed --class=UsersTableSeeder

你也可以在使用 migrate:refresh 命令时运行 seed，这将回滚所有的迁移，然后再执行迁移，之后进行填充数据。这条命令对于应用的数据库重置非常有用：

php artisan migrate:refresh --seed