初めに

こんばんは、だいごです。
今回は、最近学習を始めたLaravelのマイグレーションについてまとめていこうと思います。
たまに、Railsとの比較を交えながらまとめていきます。
よかったらご覧ください。

マイグレーションの生成

まずは、マイグレーションの生成を行います。
生成に関するコードは以下になります。

# Laravel
% php artisan make:migration create_テーブル名（複数形）_table

# Ruby on Rails
% rails g model モデル名（単数系）

このコマンドのポイントとしては、テーブル名が複数形になるところです。
Railsではテーブル名は単数系なので、注意が必要です。

マイグレーションの構造

ここでは、生成されたマイグレーションを見ていきます。

<?php

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

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('テーブル名', function (Blueprint $table) {
            $table->id();
            $table->データの型('カラム名');  /* カラムの追加 */
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::drop('テーブル名');
    }
};

ここでのポイントは、upとdownのメソッドです。
upメソッドは、データベースに新しいテーブル、カラム、またはインデックスを追加するために使用し、
downメソッドは、upメソッドの逆の操作を行い、テーブルやカラムの削除やupメソッドが行なった操作を戻すために使用します。

また、$table->データの型('カラム名')をupメソッド内に記載することでカラムの追加をすることができます。

マイグレーションの実行

ここからは、生成したマイグレーションを実行していきます。
以下のコマンドを実行します。

# Laravel
% php artisan migrate

# Ruby on Rails
% rails db:migrate

このマイグレーションが実行されているか確認する場合には、以下のコマンドを実行します。

# Laravel
% php artisan migrate:status

# Ruby on Rails
% rails db:migrate:status

この２つのコマンドはLaravelもRailsもかなり似ているように感じます。

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

最新のマイグレーションを１つロールバックしたい場合には、以下のコマンドを実行します。

# Laravel
% php artisan migrate:rollback

# Ruby on Rails
% rails db:rollback

また、上記のコマンドでは最新の１つのマイグレーションしかロールバックできないため、stepオプションを与えることで、複数のマイグレーションをロールバックすることができます。

# Laravel
% php artisan migrate:rollback　--step=数値

上記のように記載した場合には、最新のマイグレーションを数値の分だけロールバックできます。
さらに、全てのマイグレーションをロールバックしたい場合には、以下のコマンドを実行します。

# Laravel
% php artisan migrate:reset

他にも、マイグレーションのロールバックと実行を１つのコマンドで実行できるものがありますが、今回は省略します。
最後に、参考を載せるのでそちらをご覧ください。

テーブル/カラムの存在確認

ここでは、hasTableおよびhasColumnメソッドを使用して、テーブルまたは列の存在を確認していきます。

# laravel
if (Schema::hasTable('テーブル名')) {
    // "users"テーブルは存在していた
}
# laravel
if (Schema::hasColumn('テーブル名', 'カラム名')) {
    // "カラム名"カラムを持つ"テーブル名"テーブルが存在していた
}

この記述を用いた条件分岐で、同名のテーブルがない場合にテーブルを作成するなどの、コードを作成できます。

終わりに

今回は自身のLaravel学習の進捗分だけマイグレーションについてまとめました。
ここに記載していないことでも重要なことはたくさんあるので、学び次第追記していこうと思います。
ご指摘・コメント等お待ちしています。
ありがとうございました。

参考