Laravelで既存のDBからマイグレーションを生成する方法！初心者向け解説

1. Laravel Migrations Generatorとは？導入のメリットを解説

1. Laravel Migrations Generatorとは？導入のメリットを解説

Laravel Migrations Generatorは、既に存在するデータベース（MySQL、MariaDB、PostgreSQL、SQL Serverなど）のテーブル構造を読み取り、自動でLaravel用のマイグレーションファイルへと変換してくれる非常に便利な拡張パッケージ（ライブラリ）です。

通常、Laravelでデータベースを管理する場合、PHPで「設計図」にあたるマイグレーションファイルをゼロから手書きする必要があります。しかし、このツールを使えば、既存のシステムをLaravelへ移行する際や、GUIツール（phpMyAdminなど）で先にテーブルを作ってしまった場合でも、一瞬でコード化できます。これにより、手作業によるタイピングミスや、データ型の指定ミスを劇的に減らすことが可能です。

インストールには、PHPのライブラリ管理ツールである「Composer」を使用します。以下のコマンドをターミナル（Mac）やコマンドプロンプト（Windows）で実行しましょう。

composer require --dev "kitloong/laravel-migrations-generator"

実行後、以下のような完了メッセージが表示されれば、あなたのLaravelプロジェクトに「自動生成機能」が追加されたことになります。

Using version ^7.0 for kitloong/laravel-migrations-generator
./composer.json has been updated
Running composer update kitloong/laravel-migrations-generator
...
Package operations: 1 install, 0 updates, 0 removals
  - Installing kitloong/laravel-migrations-generator (v7.0.0): Extracting archive
Generating optimized autoload files

これで準備は完了です。このパッケージは「開発環境（--dev）」でのみ使用する設定でインストールしているため、本番環境の動作を重くすることもなく、安全に導入できるのが特徴です。

2. マイグレーションの自動生成手順：既存データベースをLaravelへ同期

2. マイグレーションの自動生成手順：既存データベースをLaravelへ同期

パッケージの準備が整ったら、いよいよArtisan（アーティザン）コマンドを使って、データベースの構造をPHPファイルとして書き出します。Artisanとは、Laravelに標準装備されている「秘書」のようなツールで、複雑な処理をコマンド一つで代行してくれます。

プログラミング未経験の方でも、以下の手順に従うだけで、数秒でマイグレーションファイルが自動生成されます。まずは、ターミナル（コマンドプロンプト）でプロジェクトのルートディレクトリに移動し、以下の魔法の言葉を入力しましょう。

php artisan migrate:generate

このコマンドを実行すると、システムが現在のデータベースをスキャンし、テーブルごとに「いつ、どんなデータ型で作られたか」を記録したファイルを作成します。実行に成功すると、画面には以下のような結果が表示されます。

Do you want to log these migrations in the migrations table? (yes/no) [yes]:
 > yes
Migration created: 2026_02_02_000001_create_users_table.php
Migration created: 2026_02_02_000002_create_posts_table.php
Successfully created migrations!

生成されたファイルは database/migrations フォルダ内に保存されます。例えば「商品一覧（products）」というテーブルがあれば、create_products_table.php という名前で自動作成されます。これにより、手動で一つずつコードを書く手間が省けるだけでなく、記述ミスによるエラーも防ぐことができるのです。

ヒント： もし特定のテーブル（例えば users テーブル）だけを抽出したい場合は、--tables="users" というオプションを後ろに付けることで、必要な部分だけをピンポイントで生成することも可能です。状況に合わせて使い分けてみましょう。

3. 外部キーやインデックスの生成も対応

3. 外部キーやインデックスの生成も対応

Laravel Migrations Generatorは、単純なカラムだけでなく、外部キー制約やインデックス情報もマイグレーションに反映します。これにより、生成されたマイグレーションをそのままプロジェクトに適用でき、手作業で修正する手間が少なくなります。

4. 注意点と補足

4. 注意点と補足

既存のデータベースからマイグレーションを生成する際は、以下の点に注意してください。

• 生成されるマイグレーションは既存テーブルの構造をそのまま反映するため、Laravel独自の命名規則や型の変換が必要な場合があります。
• 本番環境のデータベースに直接適用する前に、必ず開発環境で確認してください。
• 複雑なリレーションや特殊なデータ型がある場合は、手作業で調整することをおすすめします。

5. まとめ的なポイント

5. まとめ的なポイント

Laravelで既存のデータベースからマイグレーションを生成するには、外部ツールのLaravel Migrations Generatorが便利です。インストール後、php artisan migrate:generateを実行するだけで、テーブル構造や外部キー、インデックスを含むマイグレーションファイルを自動で作成できます。これにより、手作業のミスを減らし、効率的にLaravelプロジェクトを構築することが可能です。