マイグレーションとシーダーはどのように機能しますか？

Question

Accepted Answer

**マイグレーション**はデータベーススキーマ（テーブルの作成・変更）をバージョン管理する、PHP で書かれた定義です。スキーマの変更はコードと一緒に追跡でき、環境全体で再現可能です。**シーダー**はテストデータやデフォルトデータをデータベースに投入します。

## マイグレーション

```php
<?php
// generate: php artisan make:migration create_users_table
return new class extends Migration {
    public function up(): void {        // apply the change
        Schema::create('users', function (Blueprint $table) {
            $table->id();                          // auto-increment primary key
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamps();                   // created_at + updated_at
        });
    }
    public function down(): void {       // reverse the change (rollback)
        Schema::dropIfExists('users');
    }
};
```

マイグレーションの `up()` はスキーマ変更を定義し（`Schema` ビルダーを使用）、`down()` はそれを元に戻します。スキーマは PHP で記述でき、SQL ではありません。また、データベースに依存しません。

## マイグレーションを実行する

```bash
php artisan migrate              # apply all pending migrations
php artisan migrate:rollback     # undo the last batch (uses down())
php artisan migrate:fresh         # drop everything and re-run all (dev)
php artisan make:migration add_phone_to_users   # a new migration to alter a table
```

マイグレーションは**バージョン管理にコミット**されるため、すべての開発者、CI、本番環境は `migrate` を実行することで同じスキーマに到達します。再現可能でチームフレンドリーです。

## シーダー — データを投入する

```php
class DatabaseSeeder extends Seeder {
    public function run(): void {
        User::factory()->count(50)->create();        // 50 fake users via a factory
        User::create(['name' => 'Admin', 'email' => 'admin@x.com']);
    }
}
// run with: php artisan db:seed
```

シーダーはデータベースにデフォルトまたはテストデータを投入します。**ファクトリ**（現実的な偽データを生成）と組み合わせると、開発やテストで非常に価値があります。

## なぜ重要なのか

マイグレーションとシーダーは、Laravel のデータベースレイヤーをプロフェッショナルでチームフレンドリーな方法で操作するために必須です。**マイグレーション**はデータベーススキーマをコードと同期させるという重要な問題を解決します。スキーマ変更をバージョン管理された PHP ファイルとして定義することで、スキーマの進化が**再現可能**（各開発者のマシン、CI、本番環境など、すべての環境が `migrate` を実行することで同じスキーマに到達）で、**追跡可能**（変更がコードと一緒にプルリクエストで確認される）で、**安全**（手動 SQL ではなく PHP でスキーマを記述でき、可逆的な `down()` メソッドを持つ）になります。

これにより、スキーマドリフトと不一致な環境を排除します。これはバグの一般的な原因です。**シーダー**（現実的な偽データを生成するファクトリと共に）は開発とテストのためにデータベースを投入し、現実的なデータで簡単に作業でき、テストシナリオを設定しやすくします。

マイグレーションワークフロー（`make:migration`、`migrate`、`rollback`）、マイグレーションが再現可能性のためにバージョン管理にコミットされること、シーダー・ファクトリがデータを投入する方法を理解することは、実際の Laravel プロジェクトでの基本的で日常的な知識です。これはチームがデータベーススキーマを共同で確実に進化させ、開発とテストのためにデータを設定する方法であり、プロフェッショナルな Laravel 開発の中心的な内容です。