Como você implanta e otimiza Laravel para produção?

Question

Accepted Answer

Implantar Laravel em produção envolve uma sequência de **comandos de otimização** (cacheamento de config/routes/views), configuração segura, execução de uma pilha adequada de servidor web e gerenciamento de filas e do scheduler. Laravel fornece comandos Artisan específicos para otimizar para produção.

## Os comandos de otimização de produção

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

Estes comandos de cacheamento são **essenciais para o desempenho em produção** — eles pré-compilam config, routes e views para que PHP não precise reanalisá-los/recompilá-los em cada requisição, uma aceleração significativa. (Nota: após o cacheamento de config, `env()` funciona apenas em arquivos de config — o código deve ler via `config()`.)

## Configuração segura de produção

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

## A pilha de servidor e processos de suporte

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

## Opções de implantação gerenciadas

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

## Por que isso importa

Implantar e otimizar Laravel para produção é conhecimento essencial para colocar aplicações em produção correta, segura e performaticamente — e envolve etapas específicas do Laravel que diferem do desenvolvimento.

Os **comandos de otimização de produção** são particularmente importantes e frequentemente negligenciados: `config:cache`, `route:cache`, `view:cache` (ou `optimize`) pré-compilam configuração, rotas e templates para que PHP não precise reanalisá-los em cada requisição, fornecendo um ganho de desempenho significativo e essencial — falhar em executar esses em produção deixa desempenho significativo na mesa.

Vários aspectos também são críticos para segurança: **`APP_DEBUG=false`** é obrigatório (modo debug vaza stack traces sensíveis e configuração para atacantes — uma vulnerabilidade séria), segredos devem ficar fora do controle de versão, e HTTPS/sessões seguras são necessários.

Entender a **pilha de servidor** apropriada (NGINX + PHP-FPM, um banco de dados real com migrations executadas no deploy, OPcache para velocidade no nível PHP) e os **processos de suporte** (workers de fila mantidos vivos via Supervisor/Horizon, entrada única de cron do scheduler, Redis para cache/sessões compartilhadas especialmente em setups stateless multi-servidor) é necessário para uma implantação de produção funcionando e performática.

Conhecer opções gerenciadas (Forge, Vapor, Envoyer para deploys zero-downtime) também é valioso.

Como toda aplicação Laravel real deve ser implantada corretamente para ser rápida e segura — e já que erros de implantação (pular caches de otimização, deixar debug ativo, lidar incorretamente com filas/scheduler) causam problemas reais de desempenho e segurança — entender a implantação e otimização de produção do Laravel (os comandos de cacheamento, configuração segura, pilha de servidor e processos de suporte) é conhecimento importante de nível sênior para entregar aplicações prontas para produção, um tópico frequentemente relevante e profissionalmente essencial.