[ Laravel 5.1 文档 ] 数据库 —— 填充数据

1、简介

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

2、编写填充器

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

php artisan make:seeder UserTableSeeder

一个填充器类默认只包含一个方法:run。当Artisan命令db:seed运行时该方法被调用。在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'),
        ]);
    }
}

2.1 使用模型工厂

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

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

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

2.2 调用额外的填充器

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

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

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

3、运行填充器

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

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

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

php artisan migrate:refresh --seed

学院君 has written 976 articles

Laravel学院院长,终身学习者

积分:111902 等级:P12 职业:手艺人 城市:杭州

9 条回复

  1. 刘欣 刘欣 says:
    @ 深深的呼吸123 感谢付上 ModelFactory.php定义代码:$factory->define(AppUser::class, function ($faker) { return [ 'name' => $faker->sentence(mt_rand(3, 10)), 'email' => str_random(10).'@gmail.com', 'password' => bcrypt('secret'), ];});不定义的话 报错信息如下 [InvalidArgumentException] Unable to locate factory with name [default] [AppUser].
  2. 漆黑烈火使 漆黑烈火使 says:
    文档漏了,需要先在database/factories/ModelFactory.php中定义
  3. 学院君 学院君 says:
    @ TRY美剧 这个是官方文档翻译过来的 刚测试了一遍 没有任何问题啊 要不您再试试?
  4. hongjian hongjian says:
    希望作者编写文档的时候,还是尽量把代码跑一遍,谢谢。
  5. hongjian hongjian says:
    @ 胖子 解决步骤: 1 安装composer 2 选择命令行进入laravel项目根目录,运行composer dump-autoload 3 运行php artisan migrate:refresh --seed
  6. hongjian hongjian says:
    $this->call(UserTableSeeder::class); 使用php artisan make:seeder UserTableSeeder生成的类居然找不到,这么明显的bug,哎。难道就没人提过这个bug吗?

登录后才能进行评论,立即登录?