Laravelでマイグレーションファイルを作成する方法を徹底解説！初心者でもわかるmake:migrationの使い方

1. マイグレーションとは？データベースの「家系図」と「設計書」

1. マイグレーションとは？データベースの「家系図」と「設計書」

Laravelのマイグレーション（Migration）とは、一言で言うと「データベースの構造をプログラムのコードで作成・管理する仕組み」のことです。通常、データベースを作るには「SQL」という専用の言語を学ぶ必要がありますが、マイグレーションを使えば、PHPのコードを書くだけでテーブルの作成や変更が可能になります。

マイグレーションの役割は、大きく分けて2つあります。

• データベースの設計書： どんな名前のテーブルに、どんな情報を入れる箱（カラム）を作るかを定義します。
• データベースの変更履歴： 「いつ、誰が、どの項目を追加したか」という履歴を保存します。これにより、過去の状態に簡単に戻したり（ロールバック）、別のパソコンで全く同じデータベースを再現したりできます。

例えば、未経験の方でも直感的に理解できる「自己紹介テーブル」を作るためのイメージコードを見てみましょう。

// このコードを実行するだけで、データベースに「自己紹介テーブル」が自動生成されます
Schema::create('profiles', function (Blueprint $table) {
    $table->id();               // ID（自動で番号が振られる）
    $table->string('nickname'); // ニックネームを保存する箱
    $table->text('bio');        // 自己紹介文を保存する広い箱
    $table->timestamps();       // 作成した日時を自動記録する
});

このように、SQL文を一行も書かずに「どんなデータが欲しいか」を日本語に近い感覚で指示できるのが、Laravelマイグレーションの最大のメリットです。チーム開発でも「このファイルを実行して！」と伝えるだけで、全員が同じデータベース構造を共有できるため、現代のWeb開発には欠かせない技術となっています。

2. マイグレーションファイルの作成コマンド

2. マイグレーションファイルの作成コマンド

マイグレーションファイルは、ターミナルで次のように入力して作成します。

php artisan make:migration create_users_table

このコマンドを実行すると、database/migrationsディレクトリの中に、新しいマイグレーションファイルが自動生成されます。

ファイル名の一例は次のようになります。

2025_10_17_000000_create_users_table.php

ファイル名の先頭には「作成日時」が付与されるため、マイグレーションの実行順序が自動で管理されます。

3. 作成されるファイルの構造を理解しよう

3. 作成されるファイルの構造を理解しよう

生成されたマイグレーションファイルを開くと、次のようなコードが含まれています。

<?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::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamps();
        });
    }

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

up()メソッドでは、テーブルを作成する処理を書きます。上記の例では「users」テーブルを作成し、id・name・email・timestampsカラムを追加しています。

down()メソッドでは、マイグレーションを元に戻す処理（テーブルの削除など）を記述します。これにより、誤ってマイグレーションを実行しても安全にロールバックできます。

4. テーブル名とファイル名の関係

4. テーブル名とファイル名の関係

make:migrationコマンドの引数には、「create_テーブル名_table」という形式を使うのが一般的です。例えば、create_posts_tableと指定すると、自動的に「posts」テーブルを作成するテンプレートが生成されます。

この命名規則を守ることで、Laravelが自動的にテーブル名を認識し、Schema::create()部分をあらかじめ記述してくれます。

5. カラムを追加するマイグレーションを作る

5. カラムを追加するマイグレーションを作る

既存のテーブルに新しいカラムを追加したい場合は、次のように作成します。

php artisan make:migration add_profile_to_users_table --table=users

--table=usersオプションを付けることで、「users」テーブルを編集するマイグレーションファイルが生成されます。

ファイルを開くと、Schema::table()メソッドを使ってカラムを追加できるようになっています。

public function up(): void
{
    Schema::table('users', function (Blueprint $table) {
        $table->string('profile')->nullable();
    });
}

6. 複数のマイグレーションを使い分けるコツ

6. 複数のマイグレーションを使い分けるコツ

Laravelのマイグレーションでは、1つのファイルにすべてのテーブルをまとめるのではなく、「1テーブル1ファイル」で管理するのがベストです。これにより、どの変更がどこで行われたかを簡単に把握でき、将来的な修正やチーム開発もスムーズになります。

また、マイグレーションファイルはバージョン管理（Gitなど）と組み合わせて利用することで、チーム全員が同じデータベース構造を再現できるという利点があります。

7. まとめ：make:migrationで効率的に開発しよう

7. まとめ：make:migrationで効率的に開発しよう

make:migrationコマンドを活用すれば、SQLの知識がなくてもLaravel内で簡単にデータベース設計ができます。データベースの変更もコードとして管理できるため、安心して試行錯誤できるのが大きな魅力です。

Laravelを使った開発では、マイグレーションを正しく使いこなすことが、効率的で安全なデータベース管理の第一歩です。

まとめ

まとめ

ここまで、Laravelにおけるマイグレーションの基本から、具体的なファイルの作成方法、そしてテーブルの構造定義やカラム追加の手順について詳しく解説してきました。マイグレーションは単にデータベースを構築するためのツールではなく、プロジェクトの成長を支える「設計図の履歴」そのものです。PHP Artisanコマンド一つで正確なファイルを生成し、バージョン管理システムと組み合わせることで、複数人でのチーム開発においても環境の差異をなくし、スムーズな連携が可能になります。

マイグレーション運用の重要ポイント

実際のプロジェクト運用では、一度本番環境に反映したマイグレーションファイルを直接編集してはいけません。構造を変更したい場合は、必ず新しいマイグレーションファイルを作成して「変更を加える」というスタンスが重要です。これにより、データベースの状態がどの時点のコードに対応しているかが明確になり、トラブル時の原因究明も容易になります。また、php artisan migrateを実行する前に、記述内容に誤りがないか再確認する癖をつけることで、不要なロールバック作業を減らすことができます。

実践的なカラム定義のバリエーション

マイグレーションファイル内では、データ型に応じた多様なメソッドが用意されています。例えば、真偽値を扱うbooleanや、大きなテキストデータを扱うtext、日付を管理するdateTimeなど、適切に使い分けることで最適なデータベース設計が可能になります。

Schema::create('articles', function (Blueprint $table) {
    $table->id(); // 自動インクリメントの主キー
    $table->string('title', 100); // 100文字制限の文字列カラム
    $table->text('content'); // 長文テキスト用
    $table->boolean('is_published')->default(false); // デフォルト値を設定
    $table->integer('view_count')->unsigned()->default(0); // 符号なし整数
    $table->foreignId('user_id')->constrained(); // 外部キー制約の追加
    $table->timestamps(); // created_atとupdated_atを自動生成
});

上記のように、オプションとして->default()や->nullable()を連結することで、カラムに詳細な制約を与えることができます。これにより、データベースレベルでの整合性を保つことができ、アプリケーションの堅牢性が向上します。

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

ファイルを作成・編集した後は、忘れずに実行コマンドを入力しましょう。現在、どのマイグレーションが実行済みかを確認するには、ステータス確認コマンドが便利です。

// 作成したマイグレーションを反映する
php artisan migrate

// 現在のマイグレーション実行状況を確認する
php artisan migrate:status

実行結果の画面では、各ファイルが「Ran（実行済み）」か「No（未実行）」かが一覧で表示されます。開発中に「あれ、あのテーブル作ったかな？」と迷ったときは、まずこのコマンドで現在の状態をチェックするようにしましょう。

+------+-------------------------------------------------------+-------+
| Ran? | Migration                                             | Batch |
+------+-------------------------------------------------------+-------+
| Yes  | 2014_10_12_000000_create_users_table                  | 1     |
| Yes  | 2014_10_12_100000_create_password_reset_tokens_table  | 1     |
| No   | 2026_01_31_100000_create_articles_table               |       |
+------+-------------------------------------------------------+-------+

よく使うロールバックコマンドの使い分け

開発を進めていると、直前の変更を取り消したい場面が多々あります。Laravelには柔軟なロールバック機能が備わっています。

• rollback: 直前のマイグレーション作業（バッチ単位）を元に戻します。
• reset: 全てのマイグレーションを元に戻し、テーブルを空にします。
• refresh: 全てのマイグレーションを戻した後、再度最初から実行します。テーブルを作り直したい時に便利です。

// 直前の操作を1ステップだけ戻す
php artisan migrate:rollback --step=1

// 全て作り直す（データの全消去に注意！）
php artisan migrate:refresh

今後の学習ステップ

マイグレーションの基本をマスターしたら、次は「シーダー（Seeder）」や「ファクトリ（Factory）」についても学んでみてください。マイグレーションで作ったテーブルに、テスト用のデータを自動で流し込むことができるようになります。これにより、手動でテストデータを登録する手間が省け、より効率的な開発サイクルを回せるようになるはずです。

Laravelの強力な機能を使いこなし、スマートなバックエンド開発を目指していきましょう！

$table->string('phone_number')->after('email');