Laravel Seeders

簡介

Laravel 可以使用 seed 類別，填充測試用的資料，或者是說這個資料表的資料都是固定的不會更動，也可以使用 seed 來創建資料

撰寫 seeder

首先透過 artisan 指令來生成 seeder 檔案，命名規則也應遵守大小寫，類似UserTableSeeder 。

php artisan make:seeder UserTableSeeder

創建完成後開啟，會看到只有一個預設的方法:run。當執行db:seed就會跑 run 底下的程式碼，在 run 方法中可以新增你想新增進資料庫的數據，可以使用 DB 或是 Eloquent ORM 對資料進行新增。

laravel 有預先有一個DatabaseSeeder的檔案，在database\seeds底下，可以在 run 裡面新增程式碼。

<?php

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

class DatabaseSeeder extends Seeder
{
    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {
        DB::table('users')->insert([
            'name' => 'joe',
            'email' => 'joe@gmail.com',
            'password' => bcrypt('secret'),
        ]);
    }
}

使用 factory 創建假資料

手動為 seed 要一一指定屬性是很麻煩的，可以使用 factory 這個輔助方法函式來新增數據到資料庫中，當一開始資料庫沒有資料，要測試的時候可以這麼做。

舉例創建 50 個 user 並與 post 關聯。

public function run()
{
    factory(App\User::class, 50)->create()->each(function($u) {
        $u->posts()->save(factory(App\Post::class)->make());
    });
}

呼叫其他 Seeders

在DatabaseSeeder類別，可以使用 call 方法執行其他的 seed 類別。
這樣可以避免單一個 seeders 過於龐大。

只需要傳遞你想要 run 的 seeder 類別名稱就好

/**
 * Run the database seeds.
 *
 * @return void
 */
public function run()
{
    Model::unguard();

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

    Model::reguard();
}

執行 seeders

一旦撰寫完成 seeder 類別，可以使用db:seed的 artisan 指令對資料庫進行填充，db:seed將會運行DatabaseSeeder類別，透過他來呼叫其他 seeders，但也可以使用—class 來單獨運行指定的 seeder 類別:

php artisan db:seed

php artisan db:seed --class=UserTableSeeder

你也可以使用 migrate:refresh 指令來對資料庫進行資料填充，它會推回所有 migration(遷移檔案)並再次執行所有遷移並執行所有 seeder。在完全重建你的資料庫時這個指令是非常有用的：

php artisan migrate:refresh --seed

Database: Seeding

https://laravel.com/docs/8.x/seeding