Vai al contenuto principale

Requisiti dell’ambiente

Prima di iniziare con Laravel ti servono i seguenti componenti:
  • PHP 8.3 o superiore
  • Composer (il package manager di PHP)
  • Installer di Laravel (opzionale ma consigliato)
Sono necessari anche Node.js/npm o Bun per compilare gli asset frontend.

Installazione di PHP e dell’installer di Laravel

Il modo più semplice per installare insieme PHP, Composer e l’installer di Laravel è eseguire il comando adatto al tuo sistema operativo.
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))
/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"
Dopo aver eseguito il comando, riavvia la sessione del terminale. Se hai già installato PHP e Composer, puoi installare solo l’installer di Laravel usando Composer.
composer global require laravel/installer
Se cerchi uno strumento grafico per gestire PHP, dai un’occhiata anche a Laravel Herd.

Creazione di una nuova applicazione Laravel

Una volta pronti PHP, Composer e l’installer di Laravel, crea una nuova applicazione Laravel. L’installer ti chiederà di scegliere il framework di test, il database e lo starter kit.
laravel new example-app
Dopo aver creato l’applicazione, avvia il server di sviluppo con lo script Composer dev.
cd example-app
npm install && npm run build
composer run dev
Quando il server di sviluppo è attivo, apri nel browser http://localhost:8000.
Usando uno starter kit viene generata automaticamente un’impalcatura di base che include l’autenticazione. In Laravel 13 puoi scegliere tra i quattro tipi: React, Vue, Svelte e Livewire.

Opzioni di starter kit

Eseguendo il comando laravel new puoi scegliere uno dei seguenti starter kit.
Starter kit con frontend React basato su Inertia. Utilizza React 19, TypeScript, Tailwind e shadcn/ui, offrendo una configurazione moderna che combina SPA e routing lato server.
Starter kit con frontend Vue basato su Inertia. Utilizza Vue Composition API, TypeScript, Tailwind e shadcn-vue.
Starter kit con frontend Svelte basato su Inertia. Utilizza Svelte 5, TypeScript, Tailwind e shadcn-svelte.
Starter kit basato su Laravel Livewire. Consente di costruire UI dinamiche usando solo PHP, ideale per team che lavorano principalmente con i template Blade. Utilizza Tailwind e Flux UI.
Se sei incerto su quale configurazione scegliere, chiarisci prima le differenze tra Blade, Livewire, Inertia e SPA in Frontend: la decisione risulterà più semplice.

Installazione con Laravel Herd

Laravel Herd è un ambiente di sviluppo Laravel/PHP nativo per macOS e Windows. Installa insieme PHP, Nginx e la CLI di Laravel.

macOS

  1. Scarica l’installer dal sito web di Herd.
  2. Esegui l’installer e PHP verrà configurato automaticamente.
  3. La directory ~/Herd verrà impostata come “parked directory”.
cd ~/Herd
laravel new my-app
cd my-app
herd open

Windows

  1. Scarica l’installer per Windows dal sito web di Herd.
  2. Dopo l’installazione, avvia Herd e completa l’onboarding.
  3. %USERPROFILE%\Herd diventa la parked directory.
cd ~\Herd
laravel new my-app
cd my-app
herd open

Configurazione iniziale

Impostazioni dell’ambiente

Molti valori di configurazione di Laravel possono variare a seconda dell’ambiente. Per questo motivo, i valori di configurazione più importanti si gestiscono nel file .env nella radice dell’applicazione.
Non fare il commit del file .env nel controllo di versione. Esiste il rischio di far trapelare informazioni sensibili.

Configurazione del database

Di default, Laravel è configurato per usare SQLite. Se usi MySQL o PostgreSQL, aggiorna il file .env.
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
Se usi un database diverso da SQLite, esegui le migration per creare le tabelle.
php artisan migrate

Supporto degli IDE

Installando la Laravel VS Code Extension ufficiale ottieni evidenziazione della sintassi, snippet, integrazione con i comandi Artisan e autocompletamento intelligente dei modelli Eloquent, e altre funzionalità di supporto a Laravel.
PhpStorm offre supporto integrato al framework Laravel, con autocompletamento intelligente per template Blade, modelli Eloquent, route, viste e traduzioni.

Prossimi passi

Struttura delle directory

Prendi confidenza con le principali directory e file di un progetto Laravel.
Ultima modifica il 13 luglio 2026