【第四弾】Laravel入門資料

マイグレーション(Migration)とは

マイグレーションとは、データベースのテーブル構造をコードで管理する仕組みです。

マイグレーションなしの問題点

従来のデータベース管理では、以下のような問題がありました:

• 手動でSQLを実行してテーブルを作成
• チームメンバー間でテーブル構造が異なる
• 本番環境と開発環境で構造が違う
• 変更履歴が追えない
• ロールバック（元に戻す）ができない

マイグレーションのメリット

• ✅ バージョン管理 - Gitでテーブル構造を管理できる
• ✅ 再現性 - コマンド1つで同じ構造を作れる
• ✅ チーム開発 - 全員が同じ構造で開発できる
• ✅ ロールバック - 変更を簡単に元に戻せる
• ✅ 履歴管理 - いつ何が変更されたかわかる

データベース設定

マイグレーションを実行する前に、データベースの接続設定を確認します。

.envファイルの設定例

プロジェクトのルートディレクトリにある .env ファイル:

# .env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=your_password

接続確認

データベースに接続できるか確認します。

php artisan migrate:status

エラーが出なければ、データベース接続成功です！

php artisan config:clear

マイグレーションの作成

実際にマイグレーションファイルを作成してみましょう。

基本的な作成コマンド

php artisan make:migration create_products_table

これにより、database/migrations/ ディレクトリに新しいマイグレーションファイルが作成されます。

ファイル名の規則

// 変更前
'timezone' => 'UTC',

// 変更後
'timezone' => env('APP_TIMEZONE', 'UTC'),

APP_TIMEZONE=Asia/Tokyo

php artisan config:clear

命名規則

テーブル構造の定義

作成されたマイグレーションファイルを開いて、テーブル構造を定義します。

マイグレーションファイルの構造

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('products');
    }
};

up() メソッド

up() メソッドは、マイグレーション実行時に呼ばれます。
ここにテーブル作成やカラム追加の処理を書きます。

down() メソッド

down() メソッドは、ロールバック時に呼ばれます。
up() で行った処理を元に戻す処理を書きます。

カラムの定義

商品テーブルを例に、実際のカラムを定義してみましょう。

public function up(): void
{
    Schema::create('products', function (Blueprint $table) {
        $table->id();                           // id (BIGINT, AUTO_INCREMENT, PRIMARY KEY)
        $table->string('name');                 // 商品名 (VARCHAR 255)
        $table->text('description');            // 説明 (TEXT)
        $table->integer('price');               // 価格 (INT)
        $table->integer('stock')->default(0);  // 在庫数 (INT, デフォルト0)
        $table->boolean('is_published')->default(false); // 公開状態 (BOOLEAN)
        $table->timestamps();                   // created_at, updated_at
    });
}

よく使うカラム型

実務でよく使うカラム型のみを紹介します。他にも多くの型がありますが、まずはこれらを覚えましょう。
データ型は、MySQLで実際に作成されるカラムの型です。

よく使うカラム修飾子

カラムに追加の設定を加えることができます。実務でよく使う修飾子のみを紹介します。

実践例: 商品テーブル

public function up(): void
{
    Schema::create('products', function (Blueprint $table) {
        $table->id();
        $table->string('name')->comment('商品名');
        $table->text('description')->nullable()->comment('商品説明');
        $table->integer('price')->comment('価格');
        $table->integer('stock')->default(0)->comment('在庫数');
        $table->boolean('is_published')->default(false)->comment('公開状態');
        $table->timestamps();
    });
}

public function down(): void
{
    Schema::dropIfExists('products');
}

✅ これで商品テーブルの構造が定義できました！

マイグレーションの実行

定義したマイグレーションを実行して、実際にテーブルを作成します。

基本的な実行コマンド

php artisan migrate

このコマンドで、まだ実行されていないマイグレーションが全て実行されます。

実行結果の例

$ php artisan migrate

   INFO  Running migrations.

  2025_01_22_000001_create_products_table ............... 15ms DONE

マイグレーションの状態確認

php artisan migrate:status

どのマイグレーションが実行済みかを確認できます。

Migration name .......................... Batch / Status
2014_10_12_000000_create_users_table ........ [1] Ran
2025_01_22_000001_create_products_table ..... [1] Ran

マイグレーションの仕組み

Laravelは、migrations というテーブルで実行履歴を管理しています。

よく使うオプション

Do you really wish to run this command? (yes/no)

✅ これでテーブルが作成されました！

ロールバックとリフレッシュ

マイグレーションは、実行した処理を元に戻すことができます。

ロールバック

最後に実行したマイグレーションを元に戻します。

php artisan migrate:rollback

これにより、down() メソッドが実行され、テーブルが削除されます。

特定のステップ数だけロールバック

# 最後の3つのバッチをロールバック
php artisan migrate:rollback --step=3

リフレッシュ（全削除して再実行）

php artisan migrate:refresh

全てのマイグレーションをロールバック（down()実行）してから、再度実行（up()実行）します。
開発中にテーブル構造を変更した時に使います。

フレッシュ（全削除して再作成）

php artisan migrate:fresh

全てのテーブルを強制的に削除（DROP）してから、マイグレーションを実行します。
down() メソッドを使わないので、refresh より高速で確実です。

コマンド比較

実践例: 開発中の流れ

# 1. マイグレーション作成
php artisan make:migration create_products_table

# 2. ファイルを編集してテーブル構造を定義

# 3. マイグレーション実行
php artisan migrate

# 4. テーブル構造を変更したい！

# 5. 一旦削除して再実行
php artisan migrate:fresh

# 6. 再度実行
php artisan migrate

✅ ロールバックを使えば、安心してテーブル構造を変更できます！

カラムの追加・変更

既存のテーブルに対して、カラムを追加・変更する方法を学びます。

カラム追加のマイグレーション作成

既存の products テーブルに新しいカラムを追加する例です。

php artisan make:migration add_category_to_products_table

カラム追加の実装

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::table('products', function (Blueprint $table) {
            $table->string('category')->nullable()->after('name');
        });
    }

    public function down(): void
    {
        Schema::table('products', function (Blueprint $table) {
            $table->dropColumn('category');
        });
    }
};

カラム変更のマイグレーション

既存のカラムの型や属性を変更することができます。

# Laravel 10以前では必要だった
composer require doctrine/dbal

# Laravel 11以降は不要！

カラム変更の実装

php artisan make:migration modify_description_in_products_table

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        // descriptionをnullableに変更
        $table->text('description')->nullable()->change();

        // nameの長さを100文字に変更
        $table->string('name', 100)->change();
    });
}

public function down(): void
{
    Schema::table('products', function (Blueprint $table) {
        $table->text('description')->change();
        $table->string('name', 255)->change();
    });
}

カラムのリネーム

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        $table->renameColumn('old_name', 'new_name');
    });
}

public function down(): void
{
    Schema::table('products', function (Blueprint $table) {
        $table->renameColumn('new_name', 'old_name');
    });
}

複数カラムの削除

public function up(): void
{
    Schema::table('products', function (Blueprint $table) {
        $table->dropColumn(['category', 'old_price']);
    });
}

外部キー制約

テーブル間のリレーション（関連）を定義するために、外部キー制約を設定します。
これは非常に重要な概念なので、しっかり理解しましょう。

外部キーとは

外部キーは、あるテーブルのカラムが、別のテーブルの主キーを参照する仕組みです。
データの整合性を保つために使われます。

なぜ外部キー制約を使うべきなのか？

// モデルで定義するリレーション（後で学習）
class Category extends Model
{
    public function products() {
        return $this->hasMany(Product::class);
    }
}

// こう書けるようになる
$category = Category::find(1);
$products = $category->products; // このカテゴリーの全商品を取得

【実践】カテゴリーと商品のリレーションを作る

実際に外部キー制約を設定してみましょう。今回は、最初からcreateマイグレーションに含める方法で実装します。

ステップ1: 既存のproductsテーブルを削除

# 既存のテーブルを削除
php artisan migrate:rollback

# または全削除
php artisan migrate:fresh

ステップ2: カテゴリーテーブル作成

php artisan make:migration create_categories_table

public function up(): void
{
    Schema::create('categories', function (Blueprint $table) {
        $table->id();
        $table->string('name')->comment('カテゴリー名');
        $table->timestamps();
    });
}

public function down(): void
{
    Schema::dropIfExists('categories');
}

ステップ3: 商品テーブルを外部キー付きで作成

既存の create_products_table マイグレーションファイルを編集します。

public function up(): void
{
    Schema::create('products', function (Blueprint $table) {
        $table->id();
        $table->string('name')->comment('商品名');
        $table->text('description')->nullable()->comment('商品説明');
        $table->integer('price')->comment('価格');
        $table->integer('stock')->default(0)->comment('在庫数');
        $table->boolean('is_published')->default(false)->comment('公開状態');

        // 外部キー
        $table->foreignId('category_id')
              ->constrained()           // categories テーブルを参照
              ->onDelete('restrict');   // カテゴリーに商品がある場合は削除不可

        $table->timestamps();
    });
}

public function down(): void
{
    Schema::dropIfExists('products');
}

ステップ4: マイグレーション実行

# マイグレーション実行
php artisan migrate

✅ これで、categoriesテーブルが先に作成され、その後productsテーブルが外部キー付きで作成されます。

SQLSTATE[HY000]: General error: 1215 Cannot add foreign key constraint
(table 'categories' doesn't exist)

外部キーの書き方

シンプルな書き方（推奨）

$table->foreignId('category_id')
      ->constrained()           // categories テーブルを自動推測
      ->onDelete('cascade');

• foreignId() は unsignedBigInteger() のショートカット
• constrained() は category_id から categories テーブルを推測

明示的な書き方

$table->foreignId('category_id')
      ->constrained('categories')  // テーブル名を明示
      ->onDelete('cascade');

従来の書き方（Laravel 6以前）

$table->unsignedBigInteger('category_id');
$table->foreign('category_id')
      ->references('id')->on('categories')
      ->onDelete('cascade');

onDelete() - 削除時の動作指定

親レコード（カテゴリー）を削除した時に、子レコード（商品）をどう扱うかを指定します。
これは非常に重要な設定で、ビジネスロジックによって使い分けます。

シーダー(Seeder)

シーダーとは、データベースに初期データを投入する仕組みです。

シーダーのメリット

• ✅ マスターデータを確実に投入できる（本番環境でも使える）
• ✅ migrate:fresh しても一発で復元できる（開発効率UP）
• ✅ チーム全員が同じデータで開発できる（属人化防止）
• ✅ Git管理できる（バージョン管理可能）

【実践】シーダーを作成してマスターデータを投入

カテゴリーと商品のマスターデータを投入するシーダーを作成します。

ステップ1: シーダーを作成

# カテゴリーのシーダー
php artisan make:seeder CategorySeeder

# 商品のシーダー
php artisan make:seeder ProductSeeder

database/seeders/ ディレクトリに2つのファイルが作成されます。

ステップ2: CategorySeeder を実装

<?php

namespace Database\Seeders;

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class CategorySeeder extends Seeder
{
    public function run(): void
    {
        DB::table('categories')->insert([
            ['name' => '家電', 'created_at' => now(), 'updated_at' => now()],
            ['name' => '食品', 'created_at' => now(), 'updated_at' => now()],
            ['name' => '衣類', 'created_at' => now(), 'updated_at' => now()],
            ['name' => '書籍', 'created_at' => now(), 'updated_at' => now()],
        ]);
    }
}

ステップ3: ProductSeeder を実装

<?php

namespace Database\Seeders;

use Illuminate\Database\Seeder;
use Illuminate\Support\Facades\DB;

class ProductSeeder extends Seeder
{
    public function run(): void
    {
        DB::table('products')->insert([
            [
                'name' => 'ノートPC',
                'description' => '高性能なノートパソコン',
                'price' => 120000,
                'stock' => 10,
                'is_published' => true,
                'category_id' => 1,  // 家電
                'created_at' => now(),
                'updated_at' => now(),
            ],
            [
                'name' => 'ワイヤレスマウス',
                'description' => '快適な操作感',
                'price' => 3000,
                'stock' => 50,
                'is_published' => true,
                'category_id' => 1,  // 家電
                'created_at' => now(),
                'updated_at' => now(),
            ],
            [
                'name' => 'オーガニックコーヒー',
                'description' => '香り高いコーヒー豆',
                'price' => 1500,
                'stock' => 30,
                'is_published' => true,
                'category_id' => 2,  // 食品
                'created_at' => now(),
                'updated_at' => now(),
            ],
            [
                'name' => 'Laravel入門書',
                'description' => '初心者向けの解説書',
                'price' => 2800,
                'stock' => 20,
                'is_published' => true,
                'category_id' => 4,  // 書籍
                'created_at' => now(),
                'updated_at' => now(),
            ],
        ]);
    }
}

ステップ4: DatabaseSeeder で実行順序を管理

database/seeders/DatabaseSeeder.php で、実行するシーダーと順序を指定します。

<?php

namespace Database\Seeders;

use Illuminate\Database\Seeder;

class DatabaseSeeder extends Seeder
{
    public function run(): void
    {
        $this->call([
            CategorySeeder::class,  // 先に実行
            ProductSeeder::class,   // 後に実行
        ]);
    }
}

ステップ5: シーダーを実行

# 全てのシーダーを実行（DatabaseSeeder の call() に書いたものを順に実行）
php artisan db:seed

# 特定のシーダーのみ実行（DatabaseSeeder に書かなくても実行可能）
php artisan db:seed --class=CategorySeeder

# migrate:fresh と同時に実行（便利！）
php artisan migrate:fresh --seed

# テーブル構造を変更
# ↓
php artisan migrate:fresh --seed
# ↓
# テーブル再作成 + マスターデータ投入 完了！

✅ シーダーを使えば、マスターデータの管理が楽になります！

まとめ

この講座で学んだマイグレーションの内容をまとめます。

マイグレーションの基本

よく使うカラム型

よく使うカラム修飾子

マイグレーションのベストプラクティス

次のステップ

マイグレーションでテーブル構造を定義できるようになりました。
次はモデル(Model)を学び、PHPからデータベースを操作する方法を学びます。