Docker para Laravel do jeito certo: Nginx + PHP 8.3 + MySQL + Redis (ambiente profissional de desenvolvimento)

Sem gambiarra, sem permissões quebradas e entendendo o porquê de cada decisão.

Introdução

Montar um ambiente Docker para Laravel parece simples, até você cair em problemas clássicos como:

• erro de permissão em storage
• PHP não se comunica com o Nginx
• Redis não conecta
• diferenças entre Windows, WSL e Linux

Neste tutorial, vou mostrar como montar um ambiente Docker profissional para rodar aplicações Laravel usando:

• Nginx
• PHP 8.3 (FPM)
• MySQL
• Redis

Tudo funcionando corretamente e entendendo por que cada configuração existe.

📦 Stack utilizada

• Docker + Docker Compose
• Nginx (alpine)
• PHP 8.3 FPM
• MySQL 8
• Redis
• Laravel

📁 Estrutura de pastas

project-root/
├── docker/
│   ├── nginx/
│   │   └── default.conf
│   └── php/
│       └── Dockerfile
├── docker-compose.yml
├── .env
└── (projeto Laravel)

🐳 docker-compose.yml

Esse arquivo é o coração do ambiente.

version: "3.9"

services:
  app:
    build:
      context: ./docker/php
    container_name: laravel_app
    volumes:
      - .:/var/www
    working_dir: /var/www
    command: >
      sh -c "
      chown -R www-data:www-data storage bootstrap/cache &&
      chmod -R 775 storage bootstrap/cache &&
      php-fpm
      "
    depends_on:
      - mysql
      - redis
    networks:
      - laravel

  nginx:
    image: nginx:alpine
    container_name: laravel_nginx
    ports:
      - "8000:80"
    volumes:
      - .:/var/www
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - app
    networks:
      - laravel

  mysql:
    image: mysql:8.0
    container_name: laravel_mysql
    restart: always
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_USER: laravel
      MYSQL_PASSWORD: laravel
      MYSQL_ROOT_PASSWORD: root
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - laravel

  redis:
    image: redis:alpine
    container_name: laravel_redis
    ports:
      - "6379:6379"
    networks:
      - laravel

networks:
  laravel:
    driver: bridge

volumes:
  mysql_data:

🔍 Por que usamos command no serviço app?

Porque as permissões do Laravel precisam ser tratadas em runtime, não no build da imagem.

Isso evita erros clássicos como:

file_put_contents(): Permission denied

🐘 Dockerfile do PHP 8.3

📁 docker/php/Dockerfile

FROM php:8.3-fpm

# Dependências do sistema
RUN apt-get update && apt-get install -y \
    git \
    curl \
    zip \
    unzip \
    libpng-dev \
    libjpeg-dev \
    libfreetype6-dev \
    libonig-dev \
    libxml2-dev \
    libzip-dev \
    libsodium-dev \
    libicu-dev \
    libpq-dev \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install \
        pdo \
        pdo_mysql \
        mbstring \
        exif \
        pcntl \
        bcmath \
        gd \
        zip \
        opcache \
        sodium \
        intl \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

# Redis
RUN pecl install redis \
    && docker-php-ext-enable redis

# Composer
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer

# Permissões
RUN chown -R www-data:www-data /var/www

WORKDIR /var/www

🌐 Configuração do Nginx

📁 docker/nginx/default.conf

server {
    listen 80;
    index index.php index.html;
    server_name localhost;
    root /var/www/public;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass app:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

    location ~ /\.ht {
        deny all;
    }
}

⚙️ Configuração do Laravel (.env)

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=laravel

REDIS_CLIENT=phpredis
REDIS_HOST=redis
REDIS_PASSWORD=null
REDIS_PORT=6379

🚀 Subindo o ambiente

docker compose up -d --build

Depois:

docker compose exec app php artisan key:generate
docker compose exec app php artisan migrate

Acesse:

http://localhost:8000

✅ Laravel rodando
✅ PHP 8.3
✅ MySQL
✅ Redis

---

❗ Erro comum: permissões no Laravel (e por que NÃO usar o Dockerfile)

Muitos tutoriais tentam resolver permissões no Dockerfile, mas isso não funciona quando usamos volumes.

❌ Erro comum no build

chmod: cannot access '/var/www/storage': No such file or directory

📌 Por quê?

• O Dockerfile roda antes do volume ser montado
• As pastas do Laravel ainda não existem nesse momento

✅ Solução correta

Tratar permissões no runtime, usando o command no docker-compose.yml, como fizemos acima.

Essa abordagem é:

• mais limpa
• mais previsível
• mais profissional

---

🧠 Conclusão

Com essa stack você tem:

• Ambiente Docker confiável para Laravel
• PHP 8.3 pronto para produção
• Redis configurado corretamente
• MySQL persistente
• Zero gambiarra de permissão

Esse setup funciona bem em:

• Windows + WSL
• Linux
• macOS