{"id":1455,"date":"2025-07-23T02:00:31","date_gmt":"2025-07-23T05:00:31","guid":{"rendered":"https:\/\/rjsites.com.br\/?p=1455"},"modified":"2025-08-12T09:15:34","modified_gmt":"2025-08-12T12:15:34","slug":"criando-um-ambiente-docker-para-instalacao-do-laravel-com-versao-de-php-personalizada","status":"publish","type":"post","link":"https:\/\/rjsites.com.br\/index.php\/2025\/07\/23\/criando-um-ambiente-docker-para-instalacao-do-laravel-com-versao-de-php-personalizada\/","title":{"rendered":"\ud83d\udc33 Criando um Ambiente Docker para Instala\u00e7\u00e3o do Laravel com Vers\u00e3o de PHP Personalizada"},"content":{"rendered":"\n
\n

Cansei de ficar trocando a vers\u00e3o do PHP no WSL! Se voc\u00ea tamb\u00e9m trabalha com m\u00faltiplos projetos PHP com vers\u00f5es diferentes, esse tutorial \u00e9 pra voc\u00ea.<\/em><\/p>\n<\/blockquote>\n\n\n\n

\ud83d\udccc Introdu\u00e7\u00e3o<\/h3>\n\n\n\n

Se voc\u00ea, assim como eu, vive criando novos projetos PHP\/Laravel com vers\u00f5es variadas do PHP (7.4, 8.1, 8.3…), sabe o quanto pode ser chato manter v\u00e1rias vers\u00f5es do PHP no mesmo sistema.<\/p>\n\n\n\n

Pensando nisso, decidi criar um ambiente isolado com Docker<\/strong>, apenas para instalar o Laravel com a vers\u00e3o correta do PHP via Composer. Assim, cada projeto roda com o que precisa, sem conflitos. Neste tutorial, vou te mostrar como configurar esse ambiente do zero.<\/p>\n\n\n\n

Ah, e se voc\u00ea ainda n\u00e3o tem o Docker instalado no seu WSL2<\/strong>, confere meu outro post:
\ud83d\udc49 Como instalar o Docker no WSL2 com Windows<\/a> (link em breve)<\/em>
<\/p>\n\n\n\n

<\/p>\n\n\n\n

\u2699\ufe0f 1. Definindo o local de instala\u00e7\u00e3o do Laravel<\/h3>\n\n\n\n

Crie uma pasta separada<\/strong> apenas para esse ambiente de instala\u00e7\u00e3o do Laravel. Isso evita conflito com os seus projetos.<\/p>\n\n\n\n

No meu caso<\/strong>, eu uso a estrutura:<\/p>\n\n\n\n

~\/rjsites\/docker\n<\/code><\/pre>\n\n\n\n
J\u00e1 os projetos Laravel ficam em:<\/p>\n\n\n\n
~\/rjsites\/\n<\/code><\/pre>\n\n\n\n
\ud83d\udee0\ufe0f 2. Criando o Dockerfile<\/h3>\n\n\n\n
Dentro da pasta ~\/rjsites\/docker<\/code>, crie um arquivo chamado Dockerfile<\/code> com o conte\u00fado abaixo:<\/p>\n\n\n\n
FROM php:8.1-fpm\n\n# Arguments defined in docker-compose.yml\nARG user\nARG uid\n\n# Install system dependencies\nRUN apt-get update && apt-get install -y \\\n    git \\\n    curl \\\n    libpng-dev \\\n    libonig-dev \\\n    libxml2-dev \\\n    zip \\\n    unzip\n\n#Install node & npm\nRUN apt-get update && apt-get install -y \\\n    nodejs \\\n    npm\n\n# Clear cache\nRUN apt-get clean && rm -rf \/var\/lib\/apt\/lists\/*\n\n# Install PHP extensions\nRUN docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd\n\n# Get latest Composer\nCOPY --from=composer:latest \/usr\/bin\/composer \/usr\/bin\/composer\n\n# Create system user to run Composer and Artisan Commands\nRUN useradd -G www-data,root -u $uid -d \/home\/$user $user\nRUN mkdir -p \/home\/$user\/.composer && \\\n    chown -R $user:$user \/home\/$user\n\n# Set working directory\nWORKDIR \/var\/www\n\nUSER $user\n<\/code><\/pre>\n\n\n\n
\n
\ud83e\udde0 Dica<\/strong>: Troque php:8.1-fpm<\/code> por php:7.4-<\/code>fpm ou php:8.3-<\/code>fpm se quiser outra vers\u00e3o.<\/p>\n<\/blockquote>\n\n\n\n
\ud83d\udcc4 3. Criando o docker-compose.yml<\/h3>\n\n\n\n
No mesmo diret\u00f3rio, crie um arquivo docker-compose.yml<\/code> com o conte\u00fado:<\/p>\n\n\n\n
version: '3.8'\nservices:\n  app:\n    build:\n      args:\n        user: ubuntuwsl\n        uid: 1000\n      context: .\/\n      dockerfile: Dockerfile\n    image: install\n    container_name: install-app\n    working_dir: \/var\/www\/\n    volumes:\n      - ~\/rjsites\/:\/var\/www\n<\/code><\/pre>\n\n\n\n
\n
Aqui o volume ~\/rjsites<\/code>\/:\/var\/www<\/code> mapeia a pasta principal (rjsites\/<\/code>) no container. Isso \u00e9 importante para que os projetos sejam criados diretamente do seu sistema de arquivos.<\/p>\n<\/blockquote>\n\n\n\n
\ud83d\ude80 4. Buildando e subindo o ambiente<\/h3>\n\n\n\n
Agora, vamos compilar o ambiente Docker e iniciar o container:<\/p>\n\n\n\n
docker compose build\ndocker compose up -d\n<\/code><\/pre>\n\n\n\n
\ud83d\udcc2 5. Criando seu projeto Laravel<\/h3>\n\n\n\n
Vamos supor que voc\u00ea quer criar um projeto chamado agendaApi<\/code>.<\/p>\n\n\n\n
    \n
  1. Entre no container:<\/li>\n<\/ol>\n\n\n\n
    docker exec -it install-app \\bash\n<\/code><\/pre>\n\n\n\n
      \n
    1. Crie a pasta do projeto:<\/li>\n<\/ol>\n\n\n\n
      mkdir ~\/rjsites\/agendaApi\n<\/code><\/pre>\n\n\n\n
        \n
      1. Navegue at\u00e9 a pasta do projeto:<\/li>\n<\/ol>\n\n\n\n
        cd agendaApi\n<\/code><\/pre>\n\n\n\n
          \n
        1. Rode o comando para instalar o Laravel:<\/li>\n<\/ol>\n\n\n\n