Come distribuisci e ottimizzi Laravel per la produzione?

Question

Accepted Answer

Distribuire Laravel in produzione comporta una sequenza di **comandi di ottimizzazione** (caching di config/routes/views), configurazione sicura, esecuzione di uno stack di server web appropriato e gestione delle code e dello scheduler. Laravel fornisce specifici comandi Artisan per ottimizzare per la produzione.

## I comandi di ottimizzazione per la produzione

```bash
# cache config, routes, and views → significant speedup (skip recompilation per request)
php artisan config:cache        # merge & cache all config into one file
php artisan route:cache          # cache compiled routes
php artisan view:cache           # precompile Blade templates
php artisan event:cache
# or all at once:
php artisan optimize

composer install --optimize-autoloader --no-dev    # optimized autoloader, no dev deps
```

Questi comandi di caching sono **essenziali per le prestazioni in produzione** — precompilano config, routes e views in modo che PHP non debba rianalizarli/ricompilarli ad ogni richiesta, un miglioramento significativo delle prestazioni. (Nota: dopo il caching della config, `env()` funziona solo nei file di config — il codice deve leggere tramite `config()`.)

## Configurazione sicura per la produzione

```bash
# .env (production)
APP_ENV=production
APP_DEBUG=false          # ❗ MUST be false — debug=true leaks sensitive info/stack traces
APP_KEY=...               # generated, kept secret
```

```text
✓ APP_DEBUG=false (leaking debug info is a serious security risk)
✓ Keep secrets in .env (gitignored) / environment; never commit them
✓ Use HTTPS; set secure session/cookie settings
```

## Lo stack di server e i processi di supporto

```text
✓ Web server: NGINX + PHP-FPM (the standard PHP production stack)
✓ Database: a real DB (MySQL/PostgreSQL) with migrations run on deploy (php artisan migrate)
✓ Queue workers: run via Supervisor (or Laravel Horizon for Redis) — keep them alive
✓ Scheduler: ONE cron entry running `schedule:run` every minute
✓ Cache/sessions: Redis (shared, fast) — especially for multi-server, keep app STATELESS
✓ Use OPcache (PHP bytecode cache) — a major PHP-level speedup
```

## Opzioni di deployment gestite

```text
Laravel Forge (server provisioning), Vapor (serverless on AWS), or platforms
(Envoyer for zero-downtime deploys) automate much of this.
```

## Perché è importante

Distribuire e ottimizzare Laravel per la produzione è una conoscenza essenziale per mettere le applicazioni in esecuzione correttamente, in modo sicuro e performante — e comporta passaggi specifici di Laravel che differiscono dallo sviluppo.

I **comandi di ottimizzazione per la produzione** sono particolarmente importanti e spesso trascurati: `config:cache`, `route:cache`, `view:cache` (o `optimize`) precompilano configurazione, routes e template in modo che PHP non debba rianalizarli ad ogni richiesta, fornendo un miglioramento delle prestazioni significativo e essenziale — non eseguire questi comandi in produzione lascia prestazioni importanti sul tavolo.

Diversi aspetti sono anche critici dal punto di vista della sicurezza: **`APP_DEBUG=false`** è obbligatorio (la modalità debug rivela tracce dello stack sensibili e configurazione agli attaccanti — una vulnerabilità seria), i segreti devono stare fuori dal controllo di versione, e HTTPS/sessioni sicure sono necessari.

Comprendere lo **stack di server** appropriato (NGINX + PHP-FPM, un database reale con migrazioni eseguite al deployment, OPcache per la velocità a livello PHP) e i **processi di supporto** (worker delle code mantenuti attivi tramite Supervisor/Horizon, l'ingresso cron singolo dello scheduler, Redis per cache/sessioni condivise specialmente in setup multi-server stateless) è necessario per un deployment di produzione funzionante e performante.

Conoscere le opzioni gestite (Forge, Vapor, Envoyer per deploy a zero downtime) è anch'essa preziosa.

Poiché ogni applicazione Laravel reale deve essere distribuita correttamente per essere veloce e sicura — e poiché gli errori di deployment (saltare i cache di ottimizzazione, lasciare debug attivo, gestire male code/scheduler) causano problemi reali di prestazioni e sicurezza — comprendere il deployment e l'ottimizzazione in produzione di Laravel (i comandi di caching, la configurazione sicura, lo stack di server e i processi di supporto) è una conoscenza importante di livello senior per spedire applicazioni pronte per la produzione, un argomento frequentemente rilevante e professionalmente essenziale.