Generator migracji Laravel

Generator migracji Laravel

Migracje to wersjonowanie struktury bazy danych. Zamiast ręcznie tworzyć tabele, opisuje się je w kodzie i uruchamia poleceniem php artisan migrate.

Format kolumny

Każda linia to typ nazwa modyfikatory:

string name
string email unique
integer age nullable
decimal price default:0

Dostępne modyfikatory

Przykład

Migracja tabeli produktów z polami name, slug, price i description generuje kod z $table->string('name'), $table->string('slug')->unique() i automatycznymi znacznikami czasu.

Jak użyć?

1. Zapisz plik w database/migrations/ z nazwą zawierającą znacznik czasu.
2. Uruchom php artisan migrate.
3. W razie potrzeby cofnij zmianę: php artisan migrate:rollback.

Jak działa generator migracji Laravel?

Generator działa na zasadzie parsera linii. Każdy wiersz, który wpiszesz, jest dzielony na trzy części: typ kolumny, jej nazwę oraz opcjonalne modyfikatory. Pierwszy token to metoda na obiekcie Blueprint, drugi trafia do niej jako argument w apostrofach, a pozostałe są doklejane jako łańcuch wywołań. Jeśli w linii nie ma modyfikatorów, generator tworzy samo wywołanie, np. $table->string('name');.

Następnie całość jest opakowywana w szkielet klasy migracji: Schema::create('nazwa_tabeli', function (Blueprint $table) { ... });. Generator nie zgaduje nazw tabel ani relacji — bierze dokładnie to, co wpiszesz. Nie tworzy też osobnych plików dla tabel powiązanych. Kolejność kolumn w wyniku odpowiada kolejności linii na wejściu, a na końcu dodawane są znaczniki czasu, czyli $table->timestamps().

Mechanizm jest deterministyczny: te same dane wejściowe dają ten sam kod wyjściowy. Nie ma tu tablic mapujących typy na SQL ani słownika poprawnych nazw. Dzięki temu narzędzie jest szybkie i przewidywalne, ale też nie wychwyci literówek. Jeśli wpiszesz typ, którego nie znasz, trafi on do kodu jako wywołanie metody, która może nie istnieć w Laravel.

Przykład krok po kroku: tabela orders

1. Wpisz nazwę tabeli: orders. To 6 znaków, które trafią do Schema::create('orders', ...).
2. Wpisz 5 linii kolumn: integer user_id, decimal total default:0, string code unique, integer quantity nullable, string status.
3. Generator rozbija każdą linię. Dla integer user_id powstaje $table->integer('user_id');. Dla decimal total default:0 — $table->decimal('total')->default(0);. Dla string code unique — $table->string('code')->unique();. Dla integer quantity nullable — $table->integer('quantity')->nullable();. Dla string status — $table->string('status');.
4. Zliczasz wywołania: 5 kolumn z wejścia + 1 wywołanie timestamps = 6 linii w ciele funkcji.
5. timestamps dodaje dwie kolumny: created_at i updated_at. Razem tabela orders ma 5 + 2 = 7 kolumn.
6. Otrzymujesz gotowy plik migracji. Zapisujesz go w database/migrations/ z nazwą zawierającą znacznik czasu i uruchamiasz php artisan migrate.

Tabela referencyjna: od wpisu do kodu

Praktyczne wskazówki

• Trzymaj nazwy w liczbie mnogiej — Laravel domyślnie mapuje model Order na tabelę orders. Jeśli użyjesz innej nazwy, musisz ustawić $table w modelu.
• Klucze obce dodawaj po kolumnach podstawowych — najpierw id, potem foreignId. Choć generator zachowa twoją kolejność, czytelniej jest zaczynać od klucza głównego.
• Modyfikatory pisz w kolejności, w jakiej mają się wykonać — np. string email unique nullable da ->unique()->nullable(). Nie ma to znaczenia dla SQL w większości przypadków, ale ułatwia czytanie.
• Nie używaj default: dla kolumn nullable bez potrzeby — domyślna wartość i NULL to dwa różne stany. Lepiej świadomie wybrać jedno.
• Po wygenerowaniu sprawdź rollback — uruchom php artisan migrate, a potem php artisan migrate:rollback, aby upewnić się, że migracja cofa się bez błędów.

Ograniczenia narzędzia

• Brak walidacji nazw tabel i kolumn — generator nie sprawdza, czy tabela już istnieje, czy nazwa nie jest zarezerwowana. Literówka trafi do kodu.
• Nie zna konwencji twojego projektu — nie uwzględnia prefiksów, osobnych schematów ani niestandardowych nazw kluczy. Wszystko musisz wpisać ręcznie.
• Nie generuje relacji zwrotnych — jeśli dodasz foreignId('user_id')->constrained(), nie powstanie automatycznie migracja dla tabeli users ani metody relacji w modelach.
• Nie obsługuje indeksów złożonych — modyfikatory unique i index działają na pojedynczej kolumnie. Dla indeksu na dwóch kolumnach musisz dopisać kod samodzielnie.

Najczęstsze pytania