Laravelのマイグレーションとは

データベースの作成や編集、削除などを管理する方法として、PHPフレームワークのLaravelには「マイグレーション」というものが備わっています。
正しくコードを書くと、だれが、いつ、どういった目的でテーブルの作成・編集・削除を行ったのかがわかる優れものです。
本記事では、基本的なマイグレーションのやり方について書きます。

詳しく知りたい方は、下記の公式ページもご参照ください。

マイグレーションの手順

マイグレーションファイルの作成
マイグレーションファイルの編集
マイグレーションの実行

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

$ php artisan make:migration create_{テーブル名}_table

コマンドプロンプト（ターミナル）で上記コマンドを実行します。
成功すれば、database/migrationsディレクトリ内にマイグレーションファイルが生成されます。

2. マイグレーションファイルの編集

下記のマイグレーションファイルは、例として{テーブル名}に「posts」を指定したときにできるものです。

2023_06_06_132828_create_posts_table.php

<?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('posts', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }

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

「up」内にはテーブル作成時の処理、「down」内にはテーブル削除時の処理を書きます。
今回は例として、post（投稿）の文章text、画像保存先imageを追記します。

2023_06_06_132828_create_posts_table.php

<?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('posts', function (Blueprint $table) {
            $table->id();
            $table->string('text');
            $table->string('image', 50);
            $table->timestamps();
        });
    }

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

テーブルカラム作成のデータ型については、下記の記事も参考にしてみてください。

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

$ php artisan migrate

初回マイグレーションではコマンドプロンプト（ターミナル）で上記コマンドを実行します。これでテーブルの生成完了です！

その他のマイグレーションコマンド

$ php artisan migrate:rollback

直前のマイグレーションをロールバックします。
（基本的に直前マイグレーションの取り消しのように振る舞いますが、実際にはマイグレーションファイルのdown()を実行しています。）

$ php artisan migrate:reset

マイグレーションをすべてロールバックします。

$ php artisan migrate:refresh

マイグレーションをすべてロールバックし、全マイグレーションを実行します。

$ php artisan migrate:fresh

データテーブルをすべて削除し、全マイグレーションを実行します。

$ php artisan migrate:status

各マイグレーションファイルの状態を表示します。

【Laravel】マイグレーションの基本