数据填充

未匹配的标注
本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

数据库: 数据填充

简介

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

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

编写数据填充

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

php artisan make:seeder UsersTableSeeder

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

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

<?php

use Illuminate\Database\Seeder;
use Illuminate\Database\Eloquent\Model;

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

使用模型工厂

手动为每一个 seed 模型一一指定属性是很麻烦的一件事。作为替代方案,你可以使用 模型工厂 来帮助你更便捷的生成大量数据库数据。首先,阅读 模型工厂的文档 来学习如何定义你的工厂。一旦工厂被定义,就能使用 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 方法来运行其它的 seed 类。为避免发生单个 seeder 类变得太大的情况,可使用 call方法来将数据填充拆分成多个文件。只需简单传递你想要运行的 seeder 类名称即可:

/**
 * 运行数据库填充。
 *
 * @return void
 */
public function run()
{
    Model::unguard();

    $this->call(UsersTableSeeder::class);
    $this->call(PostsTableSeeder::class);
    $this->call(CommentsTableSeeder::class);

    Model::reguard();
}

运行数据填充

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

php artisan db:seed

php artisan db:seed --class=UserTableSeeder

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

php artisan migrate:refresh --seed

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
讨论数量: 4
发起讨论 只看当前版本


zhangjian
App\User 下的 posts 是啥呢
0 个点赞 | 9 个回复 | 问答 | 课程版本 5.7
lrhr123
5.5 版本数据填充怎么填充中文呢
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
xycc
如何临时关掉模型的获取器
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.8
konakona
没有提到 /database/factories 的作用,单只有 Seeder 没有用的
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.7