Vai al contenuto principale

​
Perché migrare da laravel/ui

laravel/ui funziona anche su Laravel 13. In effetti l’ultima release di laravel/ui include la compatibilità con Laravel 13. Tuttavia, gli starter kit ufficiali attuali sono basati su Fortify. Continuare a usare laravel/ui finisce per allontanarti dallo stato attuale ufficiale.
Se vuoi mantenere la struttura Bootstrap + Blade esistente aumentando allo stesso tempo la manutenibilità futura, è efficace migrare a Fortify il backend di autenticazione.

​
Quadro generale della migrazione

Questa migrazione sostituisce solo il backend di autenticazione. Non serve un grande restyling della UI.
  • Fortify fornisce le rotte e la logica di autenticazione
  • I template Bootstrap + Blade esistenti continuano a essere usati
  • Nella misura necessaria, si adattano action dei form e nomi degli input
Fortify è un backend di autenticazione headless. Fortify di per sé non fornisce UI, quindi puoi continuare a usare le Blade esistenti.

​
Procedura di installazione di Fortify

1

Aggiungi il pacchetto Fortify

composer require laravel/fortify
2

Pubblica le risorse di Fortify

php artisan fortify:install
3

Esegui le migration

php artisan migrate
4

Rimuovi le rotte di Auth aggiunte da `laravel/ui`

In routes/web.php rimuovi Auth::routes(); o Auth::routes([...]). Fortify fornisce già rotte come /login, /register, /forgot-password e va evitata la duplicazione.

​
Configurare il FortifyServiceProvider

Nel file app/Providers/FortifyServiceProvider.php pubblicato da php artisan fortify:install, collega le view.
Se vuoi usare così come sono le resources/views/auth esistenti, la parte chiave della migrazione è la seguente configurazione. 
use Laravel\Fortify\Fortify;

public function boot(): void
{
    Fortify::viewPrefix('auth.');
    Fortify::requestPasswordResetLinkView('auth.passwords.email');
    Fortify::resetPasswordView('auth.passwords.reset');
    Fortify::confirmPasswordView('auth.passwords.confirm');
    Fortify::verifyEmailView('auth.verify');
}

​
Modifiche minime ai template Blade

Dopo la migrazione, verifica nelle Blade esistenti quanto segue.
  • L’action del form punta agli endpoint di Fortify (es. /login, /register, /forgot-password). Nella maggior parte dei casi, essendo specificato tramite route name come route('login') o route('register'), ci sono pochi punti da modificare. Solo route('verification.resend') va cambiato in route('verification.send'), come previsto da Fortify.
In auth/passwords/reset.balde.php servono due modifiche. 
<input type="hidden" name="token" value="{{ $token }}">
↓ 
<input type="hidden" name="token" value="{{ $request->route('token') }}">

{{ $email ?? old('email') }}
↓ 
{{ old('email', $request->email) }}

​
Disabilita le funzionalità superflue

Le funzionalità che non erano in laravel/ui non sono utilizzabili, quindi disabilitale in config/fortify.php. Puoi abilitarle preparando nuovi file di view. 
    'features' => [
        Features::registration(),
        Features::resetPasswords(),
        // Features::emailVerification(),
        // Features::updateProfileInformation(),
        // Features::updatePasswords(),
        // Features::twoFactorAuthentication([
        //     'confirm' => true,
        //     'confirmPassword' => true,
            // 'window' => 0,
        // ]),
        // Features::passkeys([
        //     'confirmPassword' => true,
        // ]),
    ],

​
Checklist di verifica

Dopo la migrazione verifica almeno quanto segue.
1

Verifica login / logout

Fai login con un utente esistente e controlla che la sessione venga mantenuta correttamente.
2

Verifica la registrazione

Controlla che la registrazione di un nuovo utente vada a buon fine e reindirizzi alla schermata prevista.
3

Verifica il reset password

Verifica l’intero flusso, dall’invio dell’email di reset al link con token, fino al completamento del cambio password.

​
Vantaggi dopo la migrazione

Eseguendo questa migrazione, la tua applicazione si avvicina alla base Fortify degli starter kit attuali.
Di conseguenza sarà più facile abilitare in futuro 2FA o passkey.

Laravel Fortify e starter kit

Consulta questa pagina se vuoi procedere fino al design interno di Fortify, 2FA e abilitazione delle passkey.
Ultima modifica il 13 luglio 2026

Argomenti correlati

Guida di migrazione dalla vecchia alla nuova strutturaFAQ sulla nuova struttura dell'app da Laravel 11Guida all'aggiornamento da Laravel 11 a 12Guida allo sviluppo di app con l'API del motore - VOICEVOX for LaravelLaravel Fortify e gli starter kit