Running and rolling back migrations in Laravel

Introduction

Migrations help you change your database step-by-step. Running migrations applies changes. Rolling back undoes them if needed.

When you add a new table or column to your database

When you fix a mistake in a previous database change

When you want to reset your database to a previous state during development

When you share your database changes with your team

When testing database changes before going live

Syntax

Laravel

php artisan migrate
php artisan migrate:rollback

php artisan migrate runs all new migrations.

php artisan migrate:rollback undoes the last batch of migrations.

Examples

This command runs all migrations that have not been run yet.

Laravel

php artisan migrate

This command rolls back the last batch of migrations that were run.

Laravel

php artisan migrate:rollback

This rolls back the last two migrations.

Laravel

php artisan migrate:rollback --step=2

This command deletes all tables and runs all migrations fresh.

Laravel

php artisan migrate:fresh

Sample Program

This migration creates a books table with id, title, author, and timestamp columns. Running php artisan migrate applies this change. Running php artisan migrate:rollback removes the books table.

Laravel

<?php

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

class CreateBooksTable extends Migration
{
    public function up()
    {
        Schema::create('books', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->string('author');
            $table->timestamps();
        });
    }

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

// To run this migration, use:
// php artisan migrate

// To roll back this migration, use:
// php artisan migrate:rollback

Important Notes

Always back up your data before rolling back migrations in production.

Rolling back only affects the last batch of migrations run together.

You can use --step to roll back multiple migrations at once.

Summary

Running migrations applies new database changes.

Rolling back migrations undoes recent changes.

Use these commands to manage your database structure safely.

Practice

1. What does the Laravel command php artisan migrate do?

easy

A. It applies all pending migrations to update the database schema.

B. It deletes all tables from the database.

C. It rolls back the last batch of migrations.

D. It creates a new migration file.

Solution

1. Step 1: Understand the purpose of migrations

   Migrations are used to update the database structure safely by applying changes.

2. Step 2: Identify the command effect

   The command php artisan migrate applies all new migrations that have not been run yet.

3. Final Answer:

   It applies all pending migrations to update the database schema. -> Option A

4. Quick Check:

   Running migrations = apply changes [OK]

Hint: Migrate means apply new changes to the database [OK]

Common Mistakes:

• Confusing migrate with rollback
• Thinking migrate deletes tables
• Assuming migrate creates files

2. Which of the following is the correct command to roll back the last batch of migrations in Laravel?

easy

A. php artisan migrate:run

B. php artisan migrate:reset

C. php artisan migrate:refresh

D. php artisan migrate:rollback

Solution

1. Step 1: Identify rollback command

   The command to undo the last batch of migrations is php artisan migrate:rollback.

2. Step 2: Differentiate from other commands

   migrate:reset rolls back all migrations, migrate:refresh rolls back and re-runs all, and migrate:run is invalid.

3. Final Answer:

   php artisan migrate:rollback -> Option D

4. Quick Check:

   Rollback = undo last batch [OK]

Hint: Rollback undoes last batch, reset undoes all [OK]

Common Mistakes:

• Using migrate:reset to rollback last batch
• Confusing migrate:refresh with rollback
• Typing migrate:run which is invalid

3. Given these commands run in order:
php artisan migrate
php artisan migrate:rollback
What is the state of the database migrations after these commands?

medium

A. All migrations are applied.

B. No migrations are applied.

C. Only the last batch of migrations is undone.

D. Migrations are partially applied and partially undone randomly.

Solution

1. Step 1: Apply migrations with migrate

   The first command applies all pending migrations, updating the database.

2. Step 2: Rollback last batch

   The second command undoes only the last batch of migrations applied, not all.

3. Final Answer:

   Only the last batch of migrations is undone. -> Option C

4. Quick Check:

   Rollback undoes last batch only [OK]

Hint: Rollback only undoes last batch, not all [OK]

Common Mistakes:

• Thinking rollback removes all migrations
• Assuming rollback does nothing
• Believing migrations are randomly undone

4. You run php artisan migrate:rollback but get an error saying "No migrations to rollback." What is the most likely cause?

medium

A. There are no migrations applied yet to rollback.

B. The migration files are missing from the migrations folder.

C. You need to run php artisan migrate:reset first.

D. The database connection is not configured.

Solution

1. Step 1: Understand rollback error

   The error means Laravel found no migrations recorded as applied to undo.

2. Step 2: Check migration status

   If no migrations were run before, rollback cannot undo anything, causing this error.

3. Final Answer:

   There are no migrations applied yet to rollback. -> Option A

4. Quick Check:

   No applied migrations = rollback error [OK]

Hint: Rollback needs applied migrations to undo [OK]

Common Mistakes:

• Assuming rollback works without applied migrations
• Thinking reset is needed before rollback
• Ignoring database connection issues

5. You want to undo all migrations and then re-run them fresh. Which command should you use?

hard

A. php artisan migrate:rollback

B. php artisan migrate:refresh

C. php artisan migrate:reset

D. php artisan migrate:fresh

Solution

1. Step 1: Understand the commands

   migrate:rollback undoes last batch, migrate:reset undoes all, migrate:refresh undoes all then re-runs, migrate:fresh drops all tables and migrates.

2. Step 2: Choose command for undo and re-run

   migrate:refresh is the command that rolls back all migrations and then runs them again fresh.

3. Final Answer:

   php artisan migrate:refresh -> Option B

4. Quick Check:

   Refresh = rollback all + migrate again [OK]

Hint: Refresh rolls back all then migrates again [OK]

Common Mistakes:

• Using rollback to undo all migrations
• Confusing reset with refresh
• Using fresh which drops tables instead of rollback