Starter Kits
Introduzione
Per offrirti un punto di partenza per la tua nuova applicazione Laravel, siamo lieti di offrire kit di autenticazione e kit di avvio dell’applicazione. Questi kit generano automaticamente le rotte, i controller e le viste necessari per registrare e autenticare gli utenti dell’applicazione.
Se desideri, puoi utilizzare questi kit di avvio, ma non sono obbligatori. Se preferisci, sei libero di costruire la tua applicazione da zero installando semplicemente una nuova copia di Laravel. In ogni caso, siamo certi che costruirai qualcosa di fantastico!
Laravel Breeze
Laravel Breeze è una semplice e minimale implementazione di tutte le funzionalità di autenticazione di Laravel, tra cui accesso, registrazione, reset della password, verifica dell’email e conferma della password. Inoltre, Breeze include una semplice pagina “profilo” in cui l’utente può aggiornare il proprio nome, indirizzo email e password.
Il livello di visualizzazione predefinito di Laravel Breeze è costituito da semplici modelli Blade stilizzati con Tailwind CSS. Oppure, Breeze può generare la struttura dell’applicazione utilizzando Vue o React e Inertia.
Breeze offre un punto di partenza eccellente per iniziare un’applicazione Laravel da zero ed è anche una scelta ottima per progetti che intendono portare i loro modelli Blade al livello successivo con Laravel Livewire.
Laravel Bootcamp
Prima di tutto, dovresti creare una nuova applicazione Laravel, configurare il tuo database e eseguire le migrazioni del database. Una volta creata la nuova applicazione Laravel, puoi installare Laravel Breeze utilizzando Composer:
composer require laravel/breeze --dev
Una volta installato Breeze, puoi generare lo scheletro della tua applicazione utilizzando uno dei “stack” di Breeze discussi nella documentazione qui di seguito.
Breeze & Blade
Dopo che Composer ha installato il pacchetto Laravel Breeze, puoi eseguire il comando Artisan breeze:install. Questo comando pubblica le viste di autenticazione, le rotte, i controller e altre risorse nella tua applicazione. Laravel Breeze pubblica tutto il suo codice nella tua applicazione, in modo che tu abbia pieno controllo e visibilità sulle sue funzionalità e implementazione.
Lo stack predefinito di Breeze è lo stack Blade, che utilizza semplici template Blade per renderizzare il frontend della tua applicazione. Lo stack Blade può essere installato invocando il comando breeze:install senza altri argomenti aggiuntivi. Dopo che lo scheletro di Breeze è stato installato, dovresti anche compilare gli asset frontend della tua applicazione:
php artisan breeze:install blade php artisan migrate npm install npm run dev
Successivamente, puoi accedere agli URL /login o /register della tua applicazione nel tuo browser web. Tutte le rotte di Breeze sono definite nel file routes/auth.php.
Dark Mode
Se desideri che Breeze includa il supporto per la modalità “dark mode” durante la creazione dello scheletro del frontend della tua applicazione, basta fornire la direttiva –dark quando esegui il comando breeze:install:
php artisan breeze:install --dark
Per saperne di più sulla compilazione del CSS e del JavaScript della tua applicazione, consulta la documentazione di Vite di Laravel.
Breeze & React / Vue
Laravel Breeze offre anche lo scaffolding di React e Vue tramite un’implementazione frontend di Inertia. Inertia ti consente di costruire applicazioni moderne con React e Vue utilizzando il classico routing lato server e i controller.
Inertia ti permette di sfruttare la potenza di React e Vue sul frontend insieme alla produttività incredibile del backend di Laravel e alla compilazione estremamente veloce di Vite. Per utilizzare uno stack Inertia, specifica vue o react come stack desiderato quando esegui il comando Artisan breeze:install. Dopo aver installato lo scaffolding di Breeze, dovresti anche compilare gli asset frontend della tua applicazione:
php artisan breeze:install vue # Or... php artisan breeze:install react php artisan migrate npm install npm run dev
Successivamente, puoi navigare agli URL /login o /register della tua applicazione nel tuo browser web. Tutte le route di Breeze sono definite nel file routes/auth.php.
Server-Side Rendering (SSR)
Se desideri che Breeze supporti la server-side rendering (SSR) di Inertia, puoi specificare l’opzione ssr durante l’esecuzione del comando breeze:install:
php artisan breeze:install vue --ssr php artisan breeze:install react --ssr
TypeScript
Quando si utilizzano gli stack Vue o React, è possibile fornire l’opzione –typescript per generare uno scheletro che include il supporto per TypeScript.
php artisan breeze:install vue --typescript php artisan breeze:install react --typescript
Breeze & Next.js / API
Laravel Breeze può anche creare uno scheletro per un’API di autenticazione pronta per autenticare applicazioni JavaScript moderne come quelle basate su Next, Nuxt e altre. Per iniziare, specifica l’opzione api come stack desiderato quando esegui il comando breeze:install di Artisan.
php artisan breeze:install api php artisan migrate
Durante l’installazione, Breeze aggiungerà una variabile d’ambiente FRONTEND_URL al file .env della tua applicazione. Questa URL dovrebbe essere l’URL della tua applicazione JavaScript, di solito sarà http://localhost:3000 durante lo sviluppo locale. Inoltre, assicurati che APP_URL sia impostato su http://localhost:8000, che è l’URL predefinito utilizzato dal comando serve di Artisan.
Implementazione di riferimento con Next.js
Infine, sei pronto per abbinare questo backend con il frontend che preferisci. Un’implementazione di riferimento di Breeze con Next.js è disponibile su GitHub. Questo frontend è mantenuto da Laravel e contiene la stessa interfaccia utente dei tradizionali stack Blade e Inertia forniti da Breeze.
Laravel Jetstream
Sebbene Laravel Breeze fornisca un punto di partenza semplice e minimale per la creazione di un’applicazione Laravel, Jetstream estende quella funzionalità con funzionalità più robuste e stack tecnologici frontend aggiuntivi. Per coloro che sono nuovi a Laravel, consigliamo di imparare le basi con Laravel Breeze prima di passare a Laravel Jetstream.
Jetstream fornisce uno scheletro di applicazione dal design elegante per Laravel e include funzionalità di accesso, registrazione, verifica dell’email, autenticazione a due fattori, gestione delle sessioni, supporto API tramite Laravel Sanctum e, opzionalmente, gestione dei team. Jetstream è progettato utilizzando Tailwind CSS e offre la scelta tra lo scaffolding frontend guidato da Livewire o Inertia.
La documentazione completa per l’installazione di Laravel Jetstream può essere trovata all’interno della documentazione ufficiale di Jetstream.