Warum von laravel/ui migrieren?
laravel/ui funktioniert auch mit Laravel 13. Das aktuelle Release von laravel/ui enthält bereits Laravel-13-Kompatibilität.
Die aktuellen offiziellen Starterkits basieren jedoch auf Fortify. Wer laravel/ui weiter betreibt, entfernt sich schrittweise vom offiziellen Ist-Zustand.Wenn Sie Ihr Bestand mit Bootstrap + Blade beibehalten, aber die Wartbarkeit für die Zukunft erhöhen möchten, ist es sinnvoll, das Auth-Backend zu Fortify zu ziehen.
Gesamtübersicht der Migration
Bei dieser Migration wird ausschließlich das Auth-Backend ausgetauscht. Ein UI-Redesign ist nicht nötig.- Fortify stellt Auth-Routen und -Verarbeitung bereit
- Vorhandene Bootstrap + Blade-Templates bleiben in Nutzung
- Formular-
actionund Feldnamen werden bei Bedarf punktuell angepasst
Fortify ist ein headless Auth-Backend. Da Fortify selbst kein UI mitbringt, können Sie Ihr vorhandenes Blade unverändert nutzen.
Fortify-Installation
FortifyServiceProvider konfigurieren
In dem durch php artisan fortify:install veröffentlichten app/Providers/FortifyServiceProvider.php verknüpfen Sie die Views.Wenn Sie die vorhandenen
resources/views/auth unverändert verwenden möchten, sind folgende Einstellungen der Kern der Migration.
Minimale Anpassungen an Blade-Templates
Prüfen Sie nach der Migration die folgenden Punkte in den bestehenden Blades:- Zeigt der Formular-
actionauf einen Fortify-Endpoint (z. B./login,/register,/forgot-password)? Da meist die Route-Namen wieroute('login')oderroute('register')verwendet werden, gibt es kaum Anpassungsbedarf. Lediglichroute('verification.resend')heißt in Fortifyroute('verification.send')und muss angepasst werden.
auth/passwords/reset.blade.php sind zwei Stellen anzupassen:
Nicht benötigte Features deaktivieren
Funktionen, die es inlaravel/ui nicht gab, sind zunächst nicht nutzbar; deaktivieren Sie sie in config/fortify.php. Wenn Sie neue View-Dateien anlegen, können Sie sie aktivieren.
Checkliste zur Funktionsprüfung
Nach der Migration prüfen Sie mindestens Folgendes:Login / Logout prüfen
Melden Sie sich mit einem bestehenden Nutzer an und stellen Sie sicher, dass die Session korrekt gehalten wird.
Registrierung prüfen
Legen Sie einen neuen Nutzer an und prüfen Sie, ob die Weiterleitung zur erwarteten Seite erfolgt.
Vorteile nach der Migration
Nach der Migration nähert sich Ihre Anwendung dem aktuellen Starterkit auf Basis von Fortify an.Dadurch lassen sich 2FA und Passkeys künftig deutlich leichter aktivieren.
Laravel Fortify und die Starterkits
Möchten Sie tiefer in Fortifys internes Design sowie 2FA und Passkeys einsteigen, konsultieren Sie diese Seite.