LaravelでファクトリとSeederを組み合わせてダミーデータを生成する方法！初心者でも簡単にテストデータ作成

1. Factory（ファクトリ）とは？ダミーデータ作成の強力な味方

1. Factory（ファクトリ）とは？ダミーデータ作成の強力な味方

LaravelのFactory（ファクトリ）は、データベースのテストや動作確認に必要な「ダミーデータ」を、まるで工場（Factory）のように自動で大量生産してくれる非常に便利な仕組みです。

プログラミングを始めたばかりの頃、動作確認のために手動でデータベースに「テスト太郎」「test@example.com」といったデータを1件ずつ入力したことはありませんか？数件なら良いですが、100件、1,000件となると現実的ではありません。Factoryを使えば、数行のコードで本物に近いデータを一瞬で用意できます。

具体的には、以下のようなデータ構成（定義）をあらかじめ決めておき、それを呼び出すことでランダムな値を生成します。

// Factoryのイメージ（※詳細は後述のステップで解説します）
[
    'user_name' => 'ランダムな氏名',
    'email' => '重複しないメールアドレス',
    'birthday' => 'ランダムな生年月日',
    'comment' => '「こんにちは！」などのランダムな文章',
];

このように、「本物に近いデータ構造」をテンプレート化しておくことで、開発効率が劇的に向上し、より実践的なテスト（ページネーションの動作確認や検索機能のテストなど）が可能になります。Laravel開発において、Seederとセットで覚えるべき必須スキルと言えるでしょう。

2. Factoryを作成する方法（Artisanコマンドの活用）

2. Factoryを作成する方法（Artisanコマンドの活用）

Laravelでテストデータを効率よく生成するために、まずは「Factory（ファクトリ）」という設計図を作成しましょう。初心者の方でも、ターミナル（Macならターミナル、WindowsならコマンドプロンプトやPowerShell）で専用のコマンドを一行実行するだけで、必要なファイルを自動生成できます。

以下のコマンドをコピーして、プロジェクトのルートディレクトリで実行してください。

php artisan make:factory UserFactory --model=User

このコマンドを実行すると、database/factories/UserFactory.php という名前のファイルが新しく作成されます。コマンドに含まれる --model=User というオプションは、「このFactoryはUserモデル（ユーザー情報）を作るための専用テンプレートですよ」とLaravelに教えるための重要な指定です。

正しくコマンドが実行されると、画面には以下のようなメッセージが表示されます。

Factory [database/factories/UserFactory.php] created successfully.

これで、ダミーデータを作るための「空の金型」が完成しました。プログラミング未経験の方は、「このコマンド一つで、データベースにデータを流し込むための下準備が整った」と考えていただければOKです。次は、このファイルの中に具体的にどんなランダムデータを生成するか、設定を書き込んでいきましょう。

3. Factoryの基本構文と記述例：テストデータの定義方法

3. Factoryの基本構文と記述例：テストデータの定義方法

Factory（ファクトリ）は、いわば「テストデータの設計図」です。Laravelでは、Faker（フェイカー）という便利なライブラリがあらかじめ組み込まれており、本物の人間が入力したような「それっぽい」データを自動で生成してくれます。

まずは、最も基本的な「ユーザー情報」を生成するコードを見てみましょう。プログラミングが初めての方でも、どの項目に何が入るかをイメージしながら読んでみてください。

use Illuminate\Database\Eloquent\Factories\Factory;
use App\Models\User;

class UserFactory extends Factory
{
    /**
     * Factoryが対応するモデル名の指定
     */
    protected $model = User::class;

    /**
     * テストデータのデフォルト状態を定義
     */
    public function definition(): array
    {
        return [
            // 日本語の名前のようなランダムな値を生成
            'name' => $this->faker->name(),
            // 他の人と重複しない、安全な形式のメールアドレス
            'email' => $this->faker->unique()->safeEmail(),
            // 全ユーザー共通で「password123」という暗号化済みパスワードを設定
            'password' => bcrypt('password123'),
        ];
    }
}

各コードの意味を詳しく解説

この設計図（definitionメソッド）の中に、データベースの列名（カラム）と、そこに入れたい値のルールを書いていきます。

• $this->faker->name()：実行するたびに「田中 太郎」や「佐藤 花子」のような名前をランダムに作ります。
• unique()：メールアドレスなど、重複してはいけないデータを作る際に「過去に作ったものと被らないようにして」と指示する命令です。
• safeEmail()：実在しないドメイン（例：example.comなど）を使ったメールアドレスを生成します。間違えて実在の人物にメールを送ってしまうリスクを防ぐ、開発者に優しい機能です。

このFactoryを1回実行すると、以下のようなデータが裏側で生成されます。まるで魔法のように、バラバラな内容が自動的にセットされます。

[
    "name" => "山田 一郎",
    "email" => "yamada.ichirou@example.net",
    "password" => "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi"
]

このように、Factoryを使うことで「手動で100人分のテストデータを入力する」といった膨大な作業から解放され、効率的な開発が可能になります。

4. Seeder（シーダー）で効率的にダミーデータを一括登録

4. Seeder（シーダー）で効率的にダミーデータを一括登録

Factory（ファクトリ）でデータの「型」を決めたら、次はSeeder（シーダー）を使って、実際にデータベースへ流し込む作業を行います。Seederとは、直訳すると「種まき機」のこと。テスト用のデータを一気に自動生成してくれる、初心者にも心強いツールです。

まずは、作成したFactoryをSeederの中で呼び出すプログラムを書きましょう。ここでは「10人分のユーザーデータを一瞬で作る」設定にしてみます。

use Illuminate\Database\Seeder;
use App\Models\User;

class UsersTableSeeder extends Seeder
{
    /**
     * データベースに対してダミーデータの「種まき」を実行します。
     */
    public function run(): void
    {
        // UserモデルのFactoryを呼び出し、count(10)で10件分を指定して作成
        User::factory()->count(10)->create();
    }
}

このコードのポイントはcount(10)という部分です。ここを100や1000に変えるだけで、手動では膨大な時間がかかるテストデータ作成が、わずか数秒で完了します。最後にcreate()を記述することで、メモリ上のデータが実際のデータベースに保存されます。

実行結果のイメージ

Seederを実行すると、データベースの「users」テーブルには以下のようなランダムなデータが自動で追加されます。プログラミング未経験の方でも、これなら名前やメールアドレスを一つずつ考える手間が省けますね。

+----+------------+---------------------------+---------------------+
| id | name       | email                     | created_at          |
+----+------------+---------------------------+---------------------+
| 1  | 田中 太郎  | tanaka@example.com        | 2026-02-01 10:00:00 |
| 2  | 佐藤 花子  | sato_h@example.jp         | 2026-02-01 10:00:01 |
| ...| ...        | ...                       | ...                 |
| 10 | 鈴木 一郎  | suzuki_i@test.com         | 2026-02-01 10:00:05 |
+----+------------+---------------------------+---------------------+

開発の初期段階で大量のデータが入った状態を確認できるため、システムが重くならないか、画面が崩れないかといった「本番に近い環境でのテスト」が非常にスムーズになります。

5. Seederを実行してデータを確認

5. Seederを実行してデータを確認

Seederを実行するには、次のコマンドを使います。

php artisan db:seed --class=UsersTableSeeder

これで、Userテーブルにダミーデータが登録されます。複数件のデータをすぐに確認できるので、開発中のテストやデザイン確認にとても便利です。

6. DatabaseSeederでまとめて実行する

6. DatabaseSeederでまとめて実行する

全てのSeederをまとめて実行したい場合は、DatabaseSeeder.phpに呼び出しを追加します。

public function run(): void
{
    $this->call(UsersTableSeeder::class);
}

その後、次のコマンドで全てのSeederが一括で実行されます。

php artisan db:seed

7. マイグレーションとSeederを組み合わせる

7. マイグレーションとSeederを組み合わせる

新しい環境を作るときは、マイグレーションでテーブルを作り、Seederでダミーデータを挿入することが便利です。次のコマンドで両方を一度に実行できます。

php artisan migrate:fresh --seed

migrate:freshは既存のテーブルを削除して再作成するコマンドです。これに--seedを付けることで、Factoryを使ったダミーデータも一緒に作成されます。

8. 開発環境と本番環境での注意点

8. 開発環境と本番環境での注意点

FactoryとSeederは開発やテスト環境で非常に便利ですが、本番環境では注意が必要です。誤ってダミーデータを本番データベースに入れると問題になる場合があります。

• 本番環境ではSeederの実行を控える
• 開発環境用のSeederはDatabaseSeederで分ける
• 必要に応じて条件分岐を入れて安全にデータ登録する

まとめ

まとめ

ここまで、LaravelにおけるFactory（ファクトリ）とSeeder（シーダー）を活用したダミーデータの生成方法について詳しく解説してきました。Webアプリケーションの開発において、実際の運用に近いデータがデータベースに入っていることは、UIの崩れを確認したり、ロジックの正確性をテストしたりする上で非常に重要です。

今回学んだ手順を振り返ると、まずは php artisan make:factory コマンドを使用して、特定のモデルに対応したファクトリファイルを作成しました。このファイル内では、PHPのライブラリである Faker を利用して、名前やメールアドレスといった情報をランダムに定義しました。これにより、手動でSQLを書いたり、GUIツールから一行ずつデータを入力したりする手間が一切なくなります。

Laravel Factoryの高度な設定とカスタマイズ

基本的な使い方の他にも、Laravelのファクトリは非常に柔軟なカスタマイズが可能です。例えば、特定の状態（ステート）を持つデータを作成したい場合などは、以下のように state メソッドを定義することが一般的です。管理権限を持つユーザーだけを生成したい場合などのコード例を見てみましょう。

/**
 * 管理ユーザー状態の定義
 */
public function admin(): static
{
    return $this->state(fn (array $attributes) => [
        'is_admin' => true,
    ]);
}

このように定義しておくことで、Seeder側から User::factory()->admin()->create(); と呼び出すだけで、特定の条件を満たしたテストデータを瞬時に作成できます。複雑なアプリケーションになればなるほど、こうした「特定の役割を持ったデータ」が必要になるため、Factoryの仕組みを理解しておくことは開発効率に直結します。

リレーション（親子関係）を持つデータの生成

また、実際のプロジェクトでは「1人のユーザーが複数の投稿（Posts）を持っている」というような、テーブル間のリレーションが存在することがほとんどです。LaravelのFactoryでは、こうした親子関係のデータもメソッドチェーンで簡単に記述できます。

// 1人のユーザーに対して、5件の投稿を紐づけて作成する例
User::factory()
    ->hasPosts(5)
    ->create();

このコード一行で、親となるユーザーレコードと、それに紐づく5つの子レコードが生成されます。データベースの外部キー制約などを意識せずに、直感的なコードでテスト環境を構築できるのがLaravelの強みです。

効率的な開発フローの確立

最後に、チーム開発や個人の開発サイクルにおいて、php artisan migrate:fresh --seed コマンドを習慣化することをおすすめします。データベースの設計変更（マイグレーションの修正）を行った際に、古いデータを一度リセットし、常に最新の定義に基づいた清潔なダミーデータを投入し直すことで、「古いデータのせいでバグが起きる」という事故を防ぐことができます。

Laravelの機能をフル活用して、面倒なデータ準備を自動化し、本質的な機能実装に集中できる環境を整えていきましょう。

// 名前だけを固定して、他の項目はFactoryに任せる
User::factory()->create([
    'name' => 'テスト太郎',
]);

Seeding: Database\Seeders\UsersTableSeeder
Database seeding completed successfully.