Starter Kit

• Introduzione
• Laravel Breeze
• Laravel Jetstream

## Introduzione

Per darti un vantaggio nella creazione della tua nuova applicazione Laravel, siamo felici di offrire kit di autenticazione e di avvio dell'applicazione. Questi kit configurano automaticamente la tua applicazione con le rotte, i controller e le viste necessari per registrare e autenticare gli utenti della tua applicazione.

Anche se sei libero di usare questi kit di avvio, non sono obbligatori. Puoi costruire la tua applicazione da zero installando semplicemente una copia fresca di Laravel. In ogni caso, siamo certi che realizzerai qualcosa di grande!

Laravel Breeze

Laravel Breeze è un’implementazione minima e semplice di tutte le funzionalità di autenticazione di Laravel, inclusi login, registrazione, reset della password, verifica dell’email e conferma della password. Inoltre, Breeze include una semplice pagina "profilo" dove l’utente può aggiornare il proprio nome, indirizzo email e password.

Il livello di visualizzazione predefinito di Laravel Breeze è composto da semplici Blade templates stilizzati con Tailwind CSS. Inoltre, Breeze offre opzioni di scaffolding basate su Livewire o Inertia, con la possibilità di utilizzare Vue o React per lo scaffolding basato su Inertia.

Laravel Bootcamp

Se sei nuovo a Laravel, sentiti libero di iniziare con il Laravel Bootcamp. Il Laravel Bootcamp ti guiderà nella creazione della tua prima applicazione Laravel utilizzando Breeze. È un ottimo modo per scoprire tutto ciò che Laravel e Breeze offrono.

Installazione

Per prima cosa, dovresti creare una nuova applicazione Laravel. Se crei la tua applicazione usando l’installer Laravel, ti verrà chiesto di installare Laravel Breeze durante il processo di installazione. Altrimenti, dovrai seguire le istruzioni di installazione manuale qui sotto.

Se hai già creato una nuova applicazione Laravel senza uno starter kit, puoi installare manualmente Laravel Breeze usando Composer:

composer require laravel/breeze --dev

Dopo che Composer ha installato il pacchetto Laravel Breeze, dovresti 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 da avere pieno controllo e visibilità sulle sue funzionalità e implementazioni.

Il comando breeze:install ti chiederà quale stack frontend e framework di testing preferisci:

php artisan breeze:install

php artisan migrate
npm install
npm run dev

Breeze e Blade

Lo stack predefinito di Breeze è quello Blade, che utilizza semplici Blade templates per rendere il frontend della tua applicazione. Lo stack Blade può essere installato eseguendo il comando breeze:install senza altri argomenti e selezionando lo stack frontend Blade. Dopo aver installato gli scaffolding di Breeze, dovresti anche compilare le risorse frontend della tua applicazione:

php artisan breeze:install

php artisan migrate
npm install
npm run dev

Successivamente, puoi visitare gli URL /login o /register della tua applicazione nel tuo browser. Tutte le route di Breeze sono definite nel file routes/auth.php.

[!NOTE]
Per saperne di più sulla compilazione di CSS e JavaScript della tua applicazione, consulta la documentazione di Vite di Laravel.

Breeze e Livewire

Laravel Breeze offre anche lo scaffolding per Livewire. Livewire è un modo potente per costruire interfacce utente front-end dinamiche e reattive usando solo PHP.

Livewire è ideale per i team che utilizzano principalmente i template Blade e cercano un’alternativa più semplice ai framework SPA basati su JavaScript come Vue e React.

Per usare lo stack Livewire, puoi selezionare lo stack frontend Livewire quando esegui il comando Artisan breeze:install. Dopo che lo scaffolding di Breeze è installato, dovresti eseguire le migrazioni del database:

php artisan breeze:install

php artisan migrate

Breeze e React / Vue

Laravel Breeze offre anche scaffolding per React e Vue tramite un’implementazione frontend Inertia. Inertia ti permette di creare applicazioni moderne a pagina singola con React e Vue utilizzando routing e controller classici lato server.

Inertia ti consente di sfruttare la potenza frontend di React e Vue combinata con l’incredibile produttività backend di Laravel e la compilazione ultraveloce di Vite. Per utilizzare uno stack Inertia, puoi selezionare gli stack frontend Vue o React durante l’esecuzione del comando Artisan breeze:install.

Quando selezioni lo stack frontend Vue o React, l’installer di Breeze ti chiederà anche se desideri Inertia SSR o il supporto TypeScript. Dopo che lo scaffolding di Breeze è installato, dovresti anche compilare le risorse frontend della tua applicazione:

php artisan breeze:install

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 rotte di Breeze sono definite nel file routes/auth.php.

Breeze e Next.js / API

Laravel Breeze può anche creare uno scaffold per un’API di autenticazione pronta ad autenticare applicazioni JavaScript moderne come quelle basate su Next, Nuxt e altre. Per iniziare, seleziona lo stack API come stack desiderato eseguendo il comando Artisan breeze:install:

php artisan breeze:install

php artisan migrate

Durante l’installazione, Breeze aggiungerà una variabile d’ambiente FRONTEND_URL al file .env della tua applicazione. Questo URL dovrebbe essere l’URL della tua applicazione JavaScript. Di solito sarà http://localhost:3000 durante lo sviluppo locale. Inoltre, assicurati che il tuo APP_URL sia impostato su http://localhost:8000, che è l’URL predefinito usato dal comando Artisan serve.

Next.js Implementazione di Riferimento

Infine, sei pronto a collegare questo backend con il frontend che preferisci. Un’implementazione di riferimento di Next per il frontend Breeze è disponibile su GitHub. Questo frontend è mantenuto da Laravel e offre la stessa interfaccia utente delle stack tradizionali Blade e Inertia fornite da Breeze.

Laravel Jetstream

Mentre Laravel Breeze fornisce un punto di partenza semplice e minimale per costruire un’applicazione Laravel, Jetstream amplia questa funzionalità con caratteristiche più robuste e ulteriori stack tecnologici frontend. Per chi è alle prime armi con Laravel, consigliamo di imparare le basi con Laravel Breeze prima di passare a Laravel Jetstream.

Jetstream offre una struttura di base per applicazioni Laravel progettata elegantemente e include login, registrazione, verifica email, autenticazione a due fattori, gestione delle sessioni, supporto API tramite Laravel Sanctum e gestione opzionale dei team. Jetstream è progettato utilizzando Tailwind CSS e offre la scelta tra una struttura frontend basata su Livewire o Inertia.

La documentazione completa per l’installazione di Laravel Jetstream è disponibile nella documentazione ufficiale di Jetstream.