Laravel — Database — Seed (官方文件原子化翻譯) | by Ray Lee | 李宗叡 | Learn or Die

Published in

Learn or Die

20 min readDec 9, 2020

# 前言

我喜歡使用 Laravel 開發的感覺, 除了開發快速, 程式碼簡潔且優雅之外, Laravel 框架本身也是一個很好的學習參照物。本篇主要將官方文件重點整理成 Q&A 的形式呈現, 原子化的概念, 這方式並不適用於每個人, 但若對你有幫助, 我會很開心。

# 版本

Laravel 8.x

# 目錄

Laravel — 官方文件原子化翻譯 — 目錄

# Writing Seeders

以下 Laravel command 的意思是？

Example:

php artisan make:seeder UserSeeder

Answer: 建立一個 seed class

以下 Laravel example code 的意思是？

Example:

<?php
class DatabaseSeeder extends Seeder
{
    public function run()
    {
        DB::table('users')->insert([
            'name' => Str::random(10),
            'email' => Str::random(10).'@gmail.com',
            'password' => Hash::make('password'),
        ]);
    }
}

Answer:

<?php
class DatabaseSeeder extends Seeder
{
    public function run()
    {
        DB::table('users')->insert([
            // 隨機產生 10 碼
            'name' => Str::random(10),
            // 同上
            'email' => Str::random(10).'@gmail.com',
            // 將 string 'password' hash 存到資料庫
            'password' => Hash::make('password'),
        ]);
    }
}

# Using Model Factories

以下 Laravel example code 的意思是？

Example:

php artisan make:factory PostFactory --model=Post

Answer: 建立一個 PostFactory, 該 factory 會產生 Post model

以下 Laravel example code 的意思是？

Example:

<?php
class UserFactory extends Factory
{
    protected $model = User::class;

    public function definition()
    {
        return [
            'name' => $this->faker->name,
            'email' => $this->faker->unique()->safeEmail,
            'email_verified_at' => now(),
            'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
            'remember_token' => Str::random(10),
        ];
    }
}

Answer:

<?php
class UserFactory extends Factory
{
    // 該 factory 對應的 model
    protected $model = User::class;

    // 定義 model 預設的狀態
    public function definition()
    {
        return [
            'name' => $this->faker->name,
            'email' => $this->faker->unique()->safeEmail,
            'email_verified_at' => now(),
            'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
            'remember_token' => Str::random(10),
        ];
    }
}

以下 Laravel 中, 位於 Factory 中的 example code 的意思是？

Example:

<?php
public function suspended()
{
    return $this->state(function (array $attributes) {
        return [
            'account_status' => 'suspended',
        ];
    });
}

Answer: 自定義一個 factory method

以下 Laravel 中, 位於 Factory 中的 example code 的意思是？

Example:

<?php
class UserFactory extends Factory
{
    protected $model = User::class;
    
    public function configure()
    {
        return $this->afterMaking(function (User $user) {
            //
        })->afterCreating(function (User $user) {
            //
        });
    }

    // ...
}

Answer:

<?php
class UserFactory extends Factory
{
    指定要建立的 model
    protected $model = User::class;
    
    public function configure()
    {
        // make model 後要做的事
        return $this->afterMaking(function (User $user) {
            //
        // create model 後要做的事
        })->afterCreating(function (User $user) {
            //
        });
    }

    // ...
}

以下 Laravel 中, 位於 model 內的 example code 的意思是？

Example:

<?php
namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    use HasFactory;
}

Answer: 當特定 model 的 Factory 被定義後, 可在 model 中 use HasFactory trait, 這樣就可以在任何地方使用 static factory method