プログラミング

Laravel マイグレーション完全ガイド

最終更新： 28/04/2025
1 分の読み

Laravelにおけるデータベースのマイグレーション（Migrations）は、データベーススキーマを管理するための強力なツールです。これにより、開発者はデータベースの変更を簡単に追跡、適用、そして共有することができます。この記事では、Laravelにおけるマイグレーションの基本的な概念から高度な利用方法までを完全かつ包括的に解説します。

マイグレーションの基本

Laravelでは、マイグレーションを使ってデータベースのテーブル構造（スキーマ）を定義し、それを管理します。これにより、テーブルの作成、変更、削除などの操作をコードで表現でき、チームでの協力や本番環境への適用が容易になります。

関連記事

1. マイグレーションの作成

マイグレーションを作成するには、artisanコマンドを使用します。以下のコマンドで新しいマイグレーションファイルを作成できます。

bash
php artisan make:migration create_posts_table

上記のコマンドは、create_posts_tableという名前のマイグレーションファイルをdatabase/migrationsディレクトリに作成します。ファイル名にはタイムスタンプが付加され、順番通りにマイグレーションが実行されるようになります。

2. マイグレーションファイルの内容

マイグレーションファイルは通常、upメソッドとdownメソッドを含みます。upメソッドはマイグレーションの適用時に実行されるコードを、downメソッドはその逆を行うコードを含みます。以下は、postsテーブルを作成する例です。

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

class CreatePostsTable extends Migration
{
    public function up()
    {
        Schema::create('posts', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->text('content');
            $table->timestamps();
        });
    }

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

この例では、postsテーブルにid、title、content、およびtimestampsカラムを作成します。downメソッドでは、テーブルを削除するコードが書かれています。

3. マイグレーションの実行

マイグレーションを実行するには、以下のコマンドを使用します。

bash
php artisan migrate

このコマンドは、未実行のマイグレーションを順番に実行し、データベースに適用します。もしマイグレーションが正常に完了すると、migrationsテーブルに実行されたマイグレーションの情報が記録されます。

4. マイグレーションのロールバック

マイグレーションを元に戻したい場合は、migrate:rollbackコマンドを使用します。このコマンドは、最後に実行したマイグレーションを取り消します。

bash
php artisan migrate:rollback

これにより、downメソッドが実行され、変更が取り消されます。

5. マイグレーションのリセット

全てのマイグレーションをリセットし、最初からやり直すには、migrate:resetコマンドを使用します。

bash
php artisan migrate:reset

このコマンドは、全てのマイグレーションのdownメソッドを実行して、すべての変更を取り消します。

6. マイグレーションの再実行

マイグレーションをリセットした後で再実行する場合は、migrate:refreshコマンドを使用します。このコマンドは、マイグレーションをリセットした後、再度実行します。

bash
php artisan migrate:refresh

これにより、マイグレーションがリセットされ、新しい状態で再実行されます。

マイグレーションにおけるカスタム操作

Laravelでは、標準的なテーブル操作以外にも、カスタム操作を行うことができます。例えば、既存のテーブルにカラムを追加したり、インデックスを作成することができます。

1. カラムの追加

既存のテーブルにカラムを追加するには、Schema::tableを使用します。例えば、postsテーブルにauthorというカラムを追加する場合、以下のようにマイグレーションを記述します。

php
class AddAuthorToPostsTable extends Migration
{
    public function up()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->string('author');
        });
    }

    public function down()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->dropColumn('author');
        });
    }
}

2. インデックスの作成

インデックスを作成するには、indexやuniqueメソッドを使用します。例えば、postsテーブルのtitleカラムにユニークインデックスを追加する場合、以下のように記述します。

php
class AddUniqueIndexToPostsTable extends Migration
{
    public function up()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->unique('title');
        });
    }

    public function down()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->dropUnique('posts_title_unique');
        });
    }
}

3. 外部キー制約の追加

外部キー制約を追加するには、foreignメソッドを使用します。例えば、postsテーブルにuser_idカラムを追加し、usersテーブルのidカラムを参照する外部キー制約を追加する場合、以下のように記述します。

php
class AddUserIdToPostsTable extends Migration
{
    public function up()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->unsignedBigInteger('user_id');
            $table->foreign('user_id')->references('id')->on('users');
        });
    }

    public function down()
    {
        Schema::table('posts', function (Blueprint $table) {
            $table->dropForeign(['user_id']);
            $table->dropColumn('user_id');
        });
    }
}

データベースの状態の管理

Laravelでは、artisanコマンドを使ってマイグレーションを管理できます。これにより、開発環境、テスト環境、本番環境で同じデータベースの状態を維持することができます。例えば、開発環境で作成したマイグレーションを、他の開発者が同じように適用できるように、マイグレーションファイルをGitなどで共有します。

まとめ

Laravelにおけるマイグレーションは、データベースのスキーマ管理を簡単にするための強力なツールです。マイグレーションを使用することで、開発者はデータベースの変更を追跡し、共有し、適用することができ、チームでの協力がスムーズになります。基本的なマイグレーションの作成から、カスタム操作や外部キー制約の追加まで、Laravelのマイグレーションは非常に柔軟で強力です。

最終更新： 28/04/2025
1 分の読み
Back to top button