数据库: 数据填充

简介

Laravel 可以简单的使用 seed 类来给数据库填充测试数据。所有的 seed 类都放在 database/seeds 目录下。你可以任意地为 Seed 类命名,但是应该遵守某些大小写规范,可用类似 UserTableSeeder 之类的命名。 Laravle 默认为你定义了一个 DatabaseSeeder 类。你可以在这个类中使用 call 方法来运行其它的 seed 类,以借此控制数据填充的顺序。

译者注: 想从已有数据库中导出数据为 Seed 文件?见 【扩展推荐】将数据导出成 Seeder 文件

编写数据填充

你可以通过 make:seeder Artisan 命令 来生成一个 Seeder。所有通过框架生成的 Seeder 都将被放置在 database/seeders 路径:

  1. php artisan make:seeder UsersTableSeeder

在 seeder 类里只有一个默认方法:run。当运行 db:seed Artisan 命令 时就会调用此方法。你可以在 run 方法中给数据库添加任何数据。你可使用 查询语句构造器Eloquent 模型工厂 来手动添加数据。

如下所示,我们将修改 Laravel 预先生成好的 DatabaseSeeder 类来给 run 方法添加一段可在数据库添加数据的语法:

  1. <?php
  2. use Illuminate\Database\Seeder;
  3. use Illuminate\Database\Eloquent\Model;
  4. class DatabaseSeeder extends Seeder
  5. {
  6. /**
  7. * 运行数据库填充。
  8. *
  9. * @return void
  10. */
  11. public function run()
  12. {
  13. DB::table('users')->insert([
  14. 'name' => str_random(10),
  15. 'email' => str_random(10).'@gmail.com',
  16. 'password' => bcrypt('secret'),
  17. ]);
  18. }
  19. }

使用模型工厂

手动为每一个 seed 模型一一指定属性是很麻烦的一件事。作为替代方案,你可以使用 模型工厂 来帮助你更便捷的生成大量数据库数据。首先,阅读 模型工厂的文档 来学习如何定义你的工厂。一旦工厂被定义,就能使用 factory 这个辅助函数函数来添加数据到数据库。

让我们来创建 50 个用户并为每个用户创建一个关联:

  1. /**
  2. * 运行数据库填充。
  3. *
  4. * @return void
  5. */
  6. public function run()
  7. {
  8. factory(App\User::class, 50)->create()->each(function($u) {
  9. $u->posts()->save(factory(App\Post::class)->make());
  10. });
  11. }

译者注:扩展阅读 - 大批量假数据填充的正确方法

调用其它的 Seeders

DatabaseSeeder 类中,你可以使用 call 方法来运行其它的 seed 类。为避免发生单个 seeder 类变得太大的情况,可使用 call方法来将数据填充拆分成多个文件。只需简单传递你想要运行的 seeder 类名称即可:

  1. /**
  2. * 运行数据库填充。
  3. *
  4. * @return void
  5. */
  6. public function run()
  7. {
  8. $this->call(UsersTableSeeder::class);
  9. $this->call(PostsTableSeeder::class);
  10. $this->call(CommentsTableSeeder::class);
  11. }

运行数据填充

一旦你编写完 seeder 类,则可以使用 db:seed Artisan 命令来对数据库进行数据填充。在默认的情况下,db:seed 命令将运行 DatabaseSeeder 类,并通过它来调用其它的 seed 类。但是,你也可以使用 --class 选项来单独运行一个特定的 seeder 类:

  1. php artisan db:seed
  2. php artisan db:seed --class=UserTableSeeder

你也可以使用 migrate:refresh 命令来对数据库进行数据填充,它会回滚并重新运行所有迁移。这在对数据库进行重构时非常有用:

  1. php artisan migrate:refresh --seed

{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译。

文档永久地址: http://d.laravel-china.org