¿Cómo despliegas y optimizas Laravel para producción?

Question

Accepted Answer

Desplegar Laravel a producción implica una secuencia de **comandos de optimización** (caché de config/rutas/vistas), configuración segura, ejecutar un stack de servidor web apropiado, y gestionar colas y el planificador. Laravel proporciona comandos Artisan específicos para optimizar para producción.

## Por qué es importante

```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
```

Estos comandos de caché son **esenciales para el rendimiento en producción** — precompilan config, rutas y vistas para que PHP no tenga que repasarlas/recompilan en cada solicitud, una aceleración significativa. (Nota: después del caché de config, `env()` solo funciona en archivos de config — el código debe leer a través de `config()`.)

## Configuración segura para producción

```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
```

## El stack del servidor y procesos de apoyo

```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
```

## Opciones de despliegue gestionado

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

## Por qué es importante

Desplegar y optimizar Laravel para producción es un conocimiento esencial para llevar aplicaciones al mercado correctamente, de manera segura y con buen rendimiento — e implica pasos específicos de Laravel que difieren del desarrollo.

Los **comandos de optimización para producción** son particularmente importantes y a menudo pasados por alto: `config:cache`, `route:cache`, `view:cache` (u `optimize`) precompilan configuración, rutas y plantillas para que PHP no tenga que repasarlas en cada solicitud, proporcionando un impulso de rendimiento significativo y esencial — no ejecutar estos en producción deja rendimiento importante sobre la mesa.

Varios aspectos también son críticos para la seguridad: **`APP_DEBUG=false`** es obligatorio (el modo debug filtra trazas de stack sensibles y configuración a atacantes — una vulnerabilidad seria), los secretos deben mantenerse fuera del control de versiones, e HTTPS/sesiones seguras son requeridas.

Entender el **stack de servidor** adecuado (NGINX + PHP-FPM, una base de datos real con migraciones ejecutadas en el despliegue, OPcache para velocidad a nivel de PHP) y los **procesos de apoyo** (workers de colas mantenidos vivos a través de Supervisor/Horizon, la entrada cron única del planificador, Redis para caché/sesiones compartidas especialmente en configuraciones stateless multi-servidor) es necesario para un despliegue en producción funcionando y performante.

Conocer opciones gestionadas (Forge, Vapor, Envoyer para despliegues sin tiempo de inactividad) también es valioso.

Ya que cada aplicación Laravel real debe desplegarse correctamente para ser rápida y segura — y ya que los errores de despliegue (omitir cachés de optimización, dejar debug activado, manejar incorrectamente colas/planificador) causan problemas reales de rendimiento y seguridad — entender el despliegue y optimización para producción de Laravel (los comandos de caché, configuración segura, stack de servidor, y procesos de apoyo) es un conocimiento importante de nivel senior para enviar aplicaciones listas para producción, un tema frecuentemente relevante y profesionalmente esencial.