Laravelのmigrateコマンド一覧|rollback・reset・refresh・freshの違いを出力で比べる
目次
- 確かめた環境
- コマンドの違いを一覧で
- php artisan migrate
- php artisan migrate:status で実行済みとバッチを見る
- php artisan migrate:rollback は最後のバッチだけ戻す
- php artisan migrate:reset はすべて戻す
- php artisan migrate:refresh は down() で戻してから migrate
- php artisan migrate:fresh はテーブルを全部消してから migrate
- down() が空だと refresh だけ失敗する
- --seed でシーダーも続けて実行する
- 本番環境(APP_ENV=production)では確認が出る
- 参考: 公式ドキュメントにあるそのほかのオプション
- 関連する記事
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 DONErollback --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 DONErefresh や 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 ファイルにまとめ、古いマイグレーションを消せるようです。




