Laravel-migraties: kolom toevoegen, terugdraaien, verwijderen

Migraties versioneren je databaseschema zoals Git je code versioneert: elke wijziging is een bestand dat je op elke omgeving opnieuw kunt afspelen. Drie handelingen dekken het dagelijkse werk: een kolom toevoegen aan een tabel die al bestaat, een migratie terugdraaien, en een bestand verwijderen dat je nooit had moeten aanmaken.

Artikel uit het leertraject Webontwikkeling. Alle commando’s en uitvoer hieronder zijn gedraaid op Laravel 13.30.1 met PHP 8.4.25.

Een migratie aanmaken

Het commando volgt een naamgevingsconventie die bepaalt wat er in het gegenereerde bestand komt:

php artisan make:migration create_tasks_table

De naam begint met create, gevolgd door de tabelnaam in het meervoud, gevolgd door table. Laravel herkent dit patroon en vult Schema::create() vooraf in met id() en timestamps(), de kolom title is hier voor het voorbeeld toegevoegd, en de gegenereerde commentaren zijn verwijderd:

<?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');
    }
};

Moet de tabel een aanmaak- en een wijzigingsdatum bijhouden, dan voegt $table->timestamps() ze toe: ontbreken ze, dan krijg je de fout ‘Unknown column ‘updated_at’’.

De migratie draaien maakt de tabel aan:

php artisan migrate

Een kolom toevoegen aan een bestaande tabel

Staat het schema er eenmaal, dan doen de gangbare Eloquent-queries de rest. Pas nooit een migratie aan die al is gedraaid: je collega’s en je servers hebben hem afgespeeld en zullen dat niet nog eens doen. Maak een nieuwe migratie en geef de betreffende tabel op met --table:

php artisan make:migration add_notes_to_tasks_table --table=tasks

Het gegenereerde bestand bevat een lege Schema::table() in beide richtingen. Vul ze in: de kolom in up(), het verwijderen ervan 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

Twee dingen zijn het waard hier herhaald te worden.

Maak de kolom nullable, of geef hem een standaardwaarde. Op een tabel die al rijen bevat, laat een kolom NOT NULL zonder standaardwaarde de migratie mislukken: de database weet niet wat ze in de bestaande rijen moet zetten.

Schrijf altijd de down(). Die maakt de migratie omkeerbaar. Een migratie zonder down() verandert het kleinste stapje terug in handwerk.

Een al gedraaide migratie terugdraaien

Kijk eerst waar je staat. migrate:status toont elke migratie met haar batch en haar status:

php artisan migrate:status

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

Een migratie met status Pending is nooit gedraaid: dat bestand mag je meteen weggooien. Een migratie met status Ran moet je eerst terugdraaien.

# draait alleen de laatste migratie terug
php artisan migrate:rollback --step=1

# draait de hele laatste batch terug
php artisan migrate:rollback

De rollback voert de methode down() uit. In het voorbeeld hierboven verdwijnt de kolom notes netjes uit de tabel en springt de migratie terug op Pending. Pas op dat moment, en geen moment eerder, mag je het bestand verwijderen.

Er bestaan twee verwante commando’s, alleen voor ontwikkeling:

# draait alles terug en speelt alles opnieuw af
php artisan migrate:refresh

# verwijdert alle tabellen en speelt daarna alles opnieuw af
php artisan migrate:fresh

Een migratie verwijderen

Er bestaat geen make:migration --delete: een migratie verwijder je door haar bestand te wissen, in database/migrations, de map die database_path() teruggeeft bij de paden van de applicatie. De enige vraag is of ze al heeft gedraaid.

Ze is nooit uitgevoerd (status Pending): verwijder het bestand, meer niet.

rm database/migrations/2026_09_02_194036_add_notes_to_tasks_table.php

Ze is al uitgevoerd (status Ran): draai haar eerst terug en verwijder daarna het bestand.

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

Een bestaande kolom wijzigen

Wil je een type, een lengte of de nullability veranderen, declareer de kolom dan opnieuw en zet er change() achter:

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

Goed nieuws voor wie van een oude versie komt: het pakket doctrine/dbal, jarenlang verplicht voor deze operatie, is dat sinds Laravel 11 niet meer. Gecontroleerd op Laravel 13.30.1, waar change() zonder extra dependency werkt.