Skip to main content

Waarom migreren vanaf laravel/ui

laravel/ui werkt ook in Laravel 13. De nieuwste release van laravel/ui bevat zelfs Laravel 13-compatibiliteit. De huidige officiële starter kits zijn echter gebaseerd op Fortify. Blijf je op laravel/ui draaien, dan drijf je langzaam af van waar de officiële stack nu staat. Wil je je bestaande Bootstrap + Blade-opzet behouden en tegelijk de onderhoudbaarheid voor de toekomst verbeteren, dan is het migreren van je authenticatiebackend naar Fortify een goede zet.

Het migratieplaatje in vogelvlucht

Bij deze migratie vervang je alleen de authenticatiebackend. Een grootschalige UI-vernieuwing is niet nodig.
  • Fortify levert de authenticatieroutes en -verwerking
  • Je bestaande Bootstrap + Blade-templates blijven behouden
  • Waar nodig pas je de action en invoernamen van formulieren aan
Fortify is een headless authenticatiebackend. Fortify zelf levert geen UI, dus je kunt je bestaande Blade-bestanden gewoon blijven gebruiken.

Installatiestappen voor Fortify

1

Voeg de Fortify-package toe

2

Publiceer de resources van Fortify

3

Voer de migraties uit

4

Verwijder de Auth-routes die laravel/ui toevoegde

Verwijder Auth::routes(); of Auth::routes([...]) uit routes/web.php. Fortify levert routes zoals /login, /register en /forgot-password, dus je moet duplicaten voorkomen.

De FortifyServiceProvider configureren

In het door php artisan fortify:install gepubliceerde bestand app/Providers/FortifyServiceProvider.php koppel je de views. Wil je je bestaande resources/views/auth blijven gebruiken, dan is deze configuratie de kern van de migratie.

Minimale aanpassingen aan de Blade-templates

Controleer na de migratie het volgende in je bestaande Blade-bestanden.
  • Wijst de action van de formulieren naar de endpoints van Fortify (bijv. /login, /register, /forgot-password)? In de meeste gevallen verwijs je via routenamen zoals route('login') en route('register'), dus er zou weinig aan te passen zijn. Alleen route('verification.resend') heet in Fortify route('verification.send') en moet dus worden aangepast.
In auth/passwords/reset.balde.php zijn twee aanpassingen nodig.

Overbodige functies uitschakelen

Functies die laravel/ui niet had, kun je niet gebruiken; schakel ze daarom uit in config/fortify.php. Je kunt ze later inschakelen door nieuwe viewbestanden aan te maken.

Checklist voor de functionele controle

Controleer na de migratie minimaal het volgende.
1

Controleer inloggen / uitloggen

Log in met een bestaande gebruiker en controleer of de sessie correct behouden blijft.
2

Controleer registreren

Controleer of een nieuwe gebruikersregistratie slaagt en er naar het verwachte scherm wordt geredirect.
3

Controleer het resetten van wachtwoorden

Controleer de volledige flow: het versturen van de resetmail, de link met token en het voltooien van de reset.

De voordelen na de migratie

Met deze migratie komt je app dicht bij dezelfde Fortify-basis als de huidige starter kits. Daardoor wordt het in de toekomst makkelijker om 2FA of passkeys in te schakelen.

Laravel Fortify en de starter kits

Raadpleeg deze pagina als je verder wilt met het interne ontwerp van Fortify en het inschakelen van 2FA en passkeys.
Laatst gewijzigd op 6 september 2026