ホーム>Laravel>Laravelのmigrateコマンド一覧|rollback・reset・refresh・freshの違いを出力で比べる
Laravel

Laravelのmigrateコマンド一覧|rollback・reset・refresh・freshの違いを出力で比べる

いつもご利用ありがとうございます。
この記事にはアフィリエイト広告を含む広告が掲載されており、その広告費によって運営しています。
Amazonのアソシエイトとして、ララテックは適格販売により収入を得ています。

Laravelのマイグレーションのコマンド(php artisan migrate・migrate:status・rollback・reset・refresh・fresh)の違いを、Laravel 13で実行した出力で比べます。バッチの単位、--step・--pretend・--seed、down()が空のときにrefreshだけ失敗する件、本番環境での確認も確かめました。

Laravel のマイグレーションには、migrate のほかに rollback・reset・refresh・fresh といったコマンドがあります。

名前が似ていて、どれを打てばいいのか迷いますよね?

この記事では、それぞれのコマンドを実際に打ったときの出力を並べて、何が戻り、何が消えるのかを比べます。

マイグレーションファイルの作り方は Laravel でデータベースを作成する方法(マイグレーション) に書いているので、ここではコマンドの違いに絞ります。

確かめた環境

2026年11月に、次の環境で確かめました。

  • Docker の php:8.4-cli(PHP 8.4.27)
  • Composer 2.11.2
  • Laravel 13.43.0(composer create-project laravel/laravel で作った直後のプロジェクト)
  • データベースは初期設定の SQLite

最初から入っている3つのマイグレーション(users・cache・jobs)に、次の2つを足して試しています。

// database/migrations/2026_11_17_191135_create_posts_table.php
public function up(): void
{
    Schema::create('posts', function (Blueprint $table) {
        $table->id();
        $table->string('title');
        $table->timestamps();
    });
}

public function down(): void
{
    Schema::dropIfExists('posts');
}
// database/migrations/2026_11_17_191136_add_category_to_posts_table.php
public function up(): void
{
    Schema::table('posts', function (Blueprint $table) {
        $table->string('category')->nullable();
    });
}

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

ファイルは php artisan make:migration create_posts_table のように作りました。

   INFO  Migration [database/migrations/2026_11_17_191135_create_posts_table.php] created successfully.

コマンドの違いを一覧で

先に結果をまとめます。

コマンドすること巻き戻す範囲残るテーブル
migrateまだ実行していないマイグレーションの up() を実行-すべて残る
migrate:status実行済みか、何番のバッチかを表示-何も変えない
migrate:rollback最後のバッチの down() を実行最後の1バッチ(--step で件数指定)他のバッチのテーブル
migrate:resetすべての down() を実行全部migrations テーブルと、マイグレーションで作っていないテーブル
migrate:refreshすべての down() を実行してから migrate全部マイグレーションで作っていないテーブル
migrate:freshすべてのテーブルを削除してから migrate(down() は使わない)なし

refresh と fresh はどちらも「作り直し」ですが、down() を使うかどうかが違います。

この違いが効いてくる場面は、後の「down() が空だと refresh だけ失敗する」で見ます。

php artisan migrate

まだ実行していないマイグレーションを、ファイル名の順に実行します。

$ php artisan migrate

   INFO  Running migrations.

  2026_11_17_191135_create_posts_table ........................... 3.09ms DONE
  2026_11_17_191136_add_category_to_posts_table .................. 0.92ms DONE

最初の3つはプロジェクトを作ったときに実行済みなので、足した2つだけが動いています。

もう一度打つと、何もしません。

$ php artisan migrate

   INFO  Nothing to migrate.

php artisan migrate:status で実行済みとバッチを見る

どこまで実行したかは migrate:status で分かります。

$ php artisan migrate:status

  Migration name .............................................. Batch / Status
  0001_01_01_000000_create_users_table ............................... [1] Ran
  0001_01_01_000001_create_cache_table ............................... [1] Ran
  0001_01_01_000002_create_jobs_table ................................ [1] Ran
  2026_11_17_191135_create_posts_table ............................... [2] Ran
  2026_11_17_191136_add_category_to_posts_table ...................... [2] Ran

[1]・[2] がバッチの番号です。

1回の migrate で実行したものが、同じ番号にまとまります。

この番号が、次の rollback で「どこまで戻すか」の単位になります。

実行していないものは Pending と表示されます。

php artisan migrate:rollback は最後のバッチだけ戻す

$ php artisan migrate:rollback

   INFO  Rolling back migrations.

  2026_11_17_191136_add_category_to_posts_table .................. 3.57ms DONE
  2026_11_17_191135_create_posts_table ........................... 0.99ms DONE

バッチ2の2つが、新しい順に戻りました。

バッチ1(users・cache・jobs)はそのままです。

  0001_01_01_000002_create_jobs_table ................................ [1] Ran
  2026_11_17_191135_create_posts_table ............................... Pending
  2026_11_17_191136_add_category_to_posts_table ...................... Pending

「1つ前のファイルだけ戻す」ではなく「最後に migrate したときの分を戻す」なので、まとめて migrate した後に rollback すると、思ったより多く戻ることがあります。

migrate --step で1ファイルずつバッチを分ける

migrate --step で実行すると、ファイルごとに別のバッチになりました。

$ php artisan migrate --step
$ php artisan migrate:status

  2026_11_17_191135_create_posts_table ............................... [2] Ran
  2026_11_17_191136_add_category_to_posts_table ...................... [3] Ran

この状態で rollback すると、バッチ3の1つだけが戻ります。

$ php artisan migrate:rollback

   INFO  Rolling back migrations.

  2026_11_17_191136_add_category_to_posts_table .................. 3.37ms DONE

rollback --step=2 で件数を指定する

バッチではなく件数で戻したいときは --step を付けます。

$ php artisan migrate:rollback --step=2

   INFO  Rolling back migrations.

  2026_11_17_191136_add_category_to_posts_table .................. 3.63ms DONE
  2026_11_17_191135_create_posts_table ........................... 0.74ms DONE

新しいほうから2件が戻りました。

rollback --pretend で実行される SQL を見る

--pretend を付けると、実行はせずに SQL だけを表示します。

$ php artisan migrate:rollback --pretend

   INFO  Rolling back migrations.

  2026_11_17_191136_add_category_to_posts_table ..............................
  ⇂ alter table "posts" drop column "category"
  2026_11_17_191135_create_posts_table .......................................
  ⇂ drop table if exists "posts"

down() に書いた内容がどんな SQL になるかを、消す前に確かめられます。

本番のデータベースで戻す前に見ておくと安心です!

php artisan migrate:reset はすべて戻す

$ php artisan migrate:reset

   INFO  Rolling back migrations.

  0001_01_01_000002_create_jobs_table ............................ 4.85ms DONE
  0001_01_01_000001_create_cache_table ........................... 2.67ms DONE
  0001_01_01_000000_create_users_table ........................... 3.38ms DONE

(このときは posts の2つを先に戻していたので、出ているのは3つです)

migrate:status はすべて Pending になりました。

データベースに残ったテーブルは migrations(と SQLite の管理用の sqlite_sequence)だけです。

reset の後に migrate すると、全部が同じバッチ [1] で実行されました。

php artisan migrate:refresh は down() で戻してから migrate

refresh は、reset と migrate を続けて打つのと同じ動きでした。

違いを見るために、posts に1行入れ、マイグレーションを使わずに memo というテーブルを直接作ってから実行します。

$ php artisan migrate:refresh

   INFO  Rolling back migrations.

  2026_11_17_191136_add_category_to_posts_table .................. 2.69ms DONE
  2026_11_17_191135_create_posts_table ........................... 0.77ms DONE
  0001_01_01_000002_create_jobs_table ............................ 3.11ms DONE
  0001_01_01_000001_create_cache_table ........................... 2.21ms DONE
  0001_01_01_000000_create_users_table ........................... 2.58ms DONE


   INFO  Running migrations.

  0001_01_01_000000_create_users_table ........................... 4.79ms DONE
  0001_01_01_000001_create_cache_table ........................... 3.05ms DONE
  0001_01_01_000002_create_jobs_table ............................ 5.38ms DONE
  2026_11_17_191135_create_posts_table ........................... 1.57ms DONE
  2026_11_17_191136_add_category_to_posts_table .................. 1.11ms DONE

実行後、posts の行数は 1 → 0 になりました。

テーブルは作り直されるので、入れたデータは消えます。

一方で、マイグレーションで作っていない memo テーブルは残っていました。

refresh が消すのは、down() に書いたものだけです。

php artisan migrate:fresh はテーブルを全部消してから migrate

$ php artisan migrate:fresh

  Dropping all tables ............................................ 2.89ms DONE

   INFO  Preparing database.

  Creating migration table ....................................... 2.21ms DONE

   INFO  Running migrations.

  0001_01_01_000000_create_users_table ........................... 4.53ms DONE
  0001_01_01_000001_create_cache_table ........................... 3.19ms DONE
  0001_01_01_000002_create_jobs_table ............................ 4.15ms DONE
  2026_11_17_191135_create_posts_table ........................... 0.62ms DONE
  2026_11_17_191136_add_category_to_posts_table .................. 0.62ms DONE

最初に Dropping all tables と出て、down() は1つも実行されていません。

実行後のテーブルの一覧から、memo も消えていました。

tables: cache, cache_locks, failed_jobs, job_batches, jobs, migrations, password_reset_tokens, posts, sessions, users

マイグレーションと関係なく作ったテーブルまで消えるので、他のアプリと共有しているデータベースでは打たないようにしましょう。

down() が空だと refresh だけ失敗する

refresh と fresh の違いが一番はっきり出るのが、down() を書き忘れたマイグレーションです。

次のように、down() が空のファイルを足しました。

// database/migrations/2026_11_17_191137_create_tags_table.php
public function up(): void
{
    Schema::create('tags', function (Blueprint $table) {
        $table->id();
        $table->string('name');
    });
}

public function down(): void
{
    // 書き忘れ
}

migrate は普通に通ります。

ところが refresh を打つと、戻す側は DONE と出るのに、作り直す側で止まりました。

$ php artisan migrate:refresh

   INFO  Rolling back migrations.

  2026_11_17_191137_create_tags_table ............................ 0.32ms DONE
  2026_11_17_191136_add_category_to_posts_table .................. 1.90ms DONE
  ...

   INFO  Running migrations.

  ...
  2026_11_17_191136_add_category_to_posts_table .................. 1.48ms DONE
  2026_11_17_191137_create_tags_table ............................ 0.94ms FAIL

   Illuminate\Database\QueryException

  SQLSTATE[HY000]: General error: 1 table "tags" already exists (Connection: sqlite, Database: /work/mig-app/database/database.sqlite, SQL: create table "tags" ("id" integer primary key autoincrement not null, "name" varchar not null))

down() が空なので、戻したことになっても tags テーブルは消えていません。

そこへ up() がもう一度 create table "tags" を打つので、「すでにある」と怒られます( ̄▽ ̄;)

migrate:rollback だけ打った場合も同じで、DONE と表示されて status は Pending になるのに、tags テーブルはデータベースに残っていました。

この後 migrate を打っても、同じ table "tags" already exists で失敗します。

fresh なら down() を使わずにテーブルを全部消すので、この状態からでも通りました。

$ php artisan migrate:fresh

  Dropping all tables ............................................ 4.44ms DONE
  ...
  2026_11_17_191137_create_tags_table ............................ 0.63ms DONE

refresh や rollback が「already exists」で止まったら、どこかの down() が空か、up() で作ったものを消しきれていないことを疑ってください。

直すときは down() に Schema::dropIfExists('tags'); のように書きます。

--seed でシーダーも続けて実行する

fresh と refresh は --seed を付けると、作り直した後にシーダーも動きます。

$ php artisan migrate:fresh --seed
  ...
  2026_11_17_191137_create_tags_table ............................ 0.71ms DONE


   INFO  Seeding database.

作ったばかりのプロジェクトの DatabaseSeeder で、users に [email protected] の1件が入りました。

シーダーの書き方は Laravel でテストデータを用意する方法(Seeder の使い方) にあります。

本番環境(APP_ENV=production)では確認が出る

.env の APP_ENV を production にして migrate:fresh を打つと、次の表示で止まりました。

$ php artisan migrate:fresh --no-interaction

                           APPLICATION IN PRODUCTION.

   WARN  Command cancelled.

--no-interaction のときは確認できないので取り消され、終了コードは1で、テーブルも消えていませんでした。

--force を付けると、確認なしで Dropping all tables から進みました。

デプロイの自動化で php artisan migrate --force と書かれているのは、このためです。

ただし fresh や refresh に --force を付けて本番で打つと、データが全部消えます。

本番で使うのは migrate --force だけにしておくのが安全ですね!

参考: 公式ドキュメントにあるそのほかのオプション

ここからは Laravel 13.x の公式ドキュメント(Database: Migrations) に書かれている内容です。

  • php artisan migrate:rollback --batch=3 のように、バッチの番号を指定して戻せるとのことです。
  • php artisan migrate --pretend で、migrate のときも SQL を表示できるとのことです。
  • php artisan migrate --isolated を付けると、複数のサーバーから同時に migrate が走らないように、キャッシュのロックを取ってから実行するようです。
  • migrate:fresh は、初期設定の接続のテーブルだけを消し、--database=admin のように接続を指定できるとのことです。
  • migrate:fresh は、テーブル名の接頭辞(prefix)に関係なく、すべてのテーブルを消すとのことです。他のアプリと共有するデータベースでは注意するよう書かれています。
  • マイグレーションのファイルが増えすぎたときは、php artisan schema:dump --prune で今のスキーマを1つの SQL ファイルにまとめ、古いマイグレーションを消せるようです。

関連する記事

フィードバックのお願い
この記事のフィードバックがありましたらYoutubeの適当な動画にコメントしていただいたり、お問い合わせからご連絡ください。