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
actionen 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
actionvan de formulieren naar de endpoints van Fortify (bijv./login,/register,/forgot-password)? In de meeste gevallen verwijs je via routenamen zoalsroute('login')enroute('register'), dus er zou weinig aan te passen zijn. Alleenroute('verification.resend')heet in Fortifyroute('verification.send')en moet dus worden aangepast.
auth/passwords/reset.balde.php zijn twee aanpassingen nodig.
Overbodige functies uitschakelen
Functies dielaravel/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.