Laravel-Migrationen: Spalte hinzufügen, zurückrollen, löschen

Migrationen versionieren dein Datenbankschema so, wie Git deinen Code versioniert: Jede Änderung ist eine Datei und lässt sich auf jeder Umgebung erneut abspielen. Drei Operationen decken den Alltag weitgehend ab: eine Spalte zu einer bestehenden Tabelle hinzufügen, eine Migration zurückrollen und eine Datei löschen, die nie hätte entstehen dürfen.

Artikel aus dem Themenpfad Webentwicklung. Alle Befehle und Ausgaben unten liefen auf Laravel 13.30.1 mit PHP 8.4.25.

Eine Migration anlegen

Der Befehl folgt einer Namenskonvention, die über den Inhalt der erzeugten Datei entscheidet:

php artisan make:migration create_tasks_table

Der Name beginnt mit create, gefolgt vom Tabellennamen im Plural und von table. Laravel erkennt dieses Muster und füllt Schema::create() mit id() und timestamps() vor, die Spalte title ist hier für das Beispiel hinzugefügt, und die generierten Kommentare wurden entfernt:

<?php

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

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('tasks', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->timestamps();
        });
    }

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

Soll die Tabelle ein Erstellungs- und ein Änderungsdatum führen, fügt $table->timestamps() beide hinzu: Fehlen sie, bekommst du den Fehler „Unknown column ‚updated_at’“.

Die Migration auszuführen legt die Tabelle an:

php artisan migrate

Eine Spalte zu einer bestehenden Tabelle hinzufügen

Steht das Schema, erledigen die gängigen Eloquent-Abfragen den Rest. Ändere nie eine Migration, die bereits gelaufen ist: Deine Kollegen und deine Server haben sie abgespielt und spielen sie kein zweites Mal. Leg eine neue Migration an und gib die betroffene Tabelle mit --table an:

php artisan make:migration add_notes_to_tasks_table --table=tasks

Die erzeugte Datei enthält ein leeres Schema::table() in beide Richtungen. Füll beide: die Spalte in up(), ihr Entfernen in down().

public function up(): void
{
    Schema::table('tasks', function (Blueprint $table) {
        $table->text('notes')->nullable()->after('title');
    });
}

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

php artisan migrate

  2026_09_02_194036_add_notes_to_tasks_table .................... 47.43ms DONE

Zwei Vorsichtsmaßnahmen sind hier eine Erinnerung wert.

Mach die Spalte nullable oder gib ihr einen Standardwert. Auf einer Tabelle, die schon Zeilen enthält, lässt eine NOT NULL-Spalte ohne Standardwert die Migration scheitern: Die Datenbank weiß nicht, was sie in die bestehenden Zeilen schreiben soll.

Schreib immer das down(). Erst dadurch wird die Migration umkehrbar. Eine Migration ohne down() macht aus dem kleinsten Rückzieher Handarbeit.

Eine bereits ausgeführte Migration zurückrollen

Sieh zuerst nach, wo du stehst. migrate:status listet jede Migration mit ihrem Batch und ihrem Zustand:

php artisan migrate:status

  2026_09_02_100000_create_tasks_table ............................... [1] Ran
  2026_09_02_194036_add_notes_to_tasks_table ......................... Pending

Eine Migration im Zustand Pending ist nie gelaufen: Ihre Datei kannst du direkt löschen. Eine Migration im Zustand Ran muss zuerst zurückgerollt werden.

# rollt nur die letzte Migration zurück
php artisan migrate:rollback --step=1

# rollt den gesamten letzten Batch zurück
php artisan migrate:rollback

Das Rollback führt die Methode down() aus. Im Beispiel oben verschwindet die Spalte notes tatsächlich aus der Tabelle, und die Migration steht wieder auf Pending. Genau dann, und keinen Moment früher, darfst du die Datei löschen.

Zwei verwandte Befehle gibt es noch, beide gehören in die Entwicklung:

# rollt alles zurück und spielt alles neu ab
php artisan migrate:refresh

# löscht alle Tabellen und spielt danach alles neu ab
php artisan migrate:fresh

Eine Migration löschen

Ein make:migration --delete gibt es nicht: Eine Migration löschst du, indem du ihre Datei in database/migrations entfernst, dem Verzeichnis, das database_path() unter den Pfaden der Anwendung zurückgibt. Die einzige Frage ist, ob sie schon gelaufen ist.

Sie ist nie gelaufen (Zustand Pending): Lösch die Datei, mehr nicht.

rm database/migrations/2026_09_02_194036_add_notes_to_tasks_table.php

Sie ist bereits gelaufen (Zustand Ran): Roll sie zuerst zurück, dann lösch die Datei.

php artisan migrate:rollback --step=1
rm database/migrations/2026_09_02_194036_add_notes_to_tasks_table.php

Eine bestehende Spalte ändern

Um einen Typ, eine Länge oder die Nullbarkeit zu ändern, deklarierst du die Spalte erneut und hängst change() an:

public function up(): void
{
    Schema::table('tasks', function (Blueprint $table) {
        $table->string('title', 500)->change();
    });
}

Gute Nachricht für alle, die von einer alten Version herkommen: Das Paket doctrine/dbal, lange Pflicht für diese Operation, ist es seit Laravel 11 nicht mehr. Geprüft auf Laravel 13.30.1, wo change() ohne zusätzliche Abhängigkeit funktioniert.