Kompatibilitätsprobleme mit PHPUnit, SQLite und dropColumn

Wenn du mit Laravel-Migrationen arbeitest und sowohl Spalten entfernen als auch hinzufügen musst, könnte dir in Verbindung mit SQLite und Tools wie PHPUnit ein Stolperstein begegnen. Denn während MySQL mit einem solchen Migrationsskript problemlos zurechtkommt, stellt SQLite hier eine Hürde dar. Ein typisches Beispiel könnte folgender Migrationscode sein:

<?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::table('my_table_name', function (Blueprint $table) {
            $table->dropColumn('my_column');

            $table->text('another_column')->nullable();
            $table->boolean('one_more_column')->nullable();
        });
    }
};

In diesem Code wird die Absicht deutlich: Eine bestehende Spalte soll entfernt und gleichzeitig mehrere neue hinzugefügt werden. Das Problem liegt bei SQLite darin, dass es das Hinzufügen von Spalten in einem solchen Kontext nicht unterstützt. Daher führt das Migrationsskript nicht die beabsichtigten Änderungen durch, was besonders dann problematisch ist, wenn du deine Tests mit SQLite über PHPUnit laufen lässt.

Um diese Problematik zu lösen, empfiehlt es sich, das Löschen und das Hinzufügen von Spalten auf zwei separate Migrationen aufzuteilen. Dadurch wird die Vorgehensweise nicht nur sauberer, sondern du stellst zudem sicher, dass deine Migrationen auf allen unterstützten Datenbanksystemen korrekt funktionieren. So könnte eine Möglichkeit aussehen, diese Aufteilung umzusetzen:

<?php

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

// Migration zum Entfernen der Spalte
return new class extends Migration
{
    public function up(): void
    {
        Schema::table('my_table_name', function (Blueprint $table) {
            $table->dropColumn('my_column');
        });
    }
};

Und dann in einer separaten Migration:

<?php

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

// Migration zum Hinzufügen der Spalten
return new class extends Migration
{
    public function up(): void
    {
        Schema::table('my_table_name', function (Blueprint $table) {
            $table->text('another_column')->nullable();
            $table->boolean('one_more_column')->nullable();
        });
    }
};

Mit dieser Strategie vermeidest du Kompatibilitätsprobleme zwischen unterschiedlichen Datenbanksystemen und sicherst zugleich eine stabile und zuverlässige Ausführung deiner Migrationsskripte. Sie ist ein gutes Beispiel dafür, wie man durch einfache Anpassungen an den Entwicklungsprozessen unvorhergesehenen Schwierigkeiten aus dem Weg gehen kann.