<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Lincoln Biancardi on Medium]]></title>
        <description><![CDATA[Stories by Lincoln Biancardi on Medium]]></description>
        <link>https://medium.com/@biancardilincoln?source=rss-b4ef76daff38------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*S4l7rFdq62iYkkofOW7NYA.jpeg</url>
            <title>Stories by Lincoln Biancardi on Medium</title>
            <link>https://medium.com/@biancardilincoln?source=rss-b4ef76daff38------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 20:54:31 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@biancardilincoln/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Guia Definitivo: Integrando Laravel, Nginx e PHP-FPM Via Socket Unix]]></title>
            <link>https://medium.com/@biancardilincoln/guia-definitivo-integrando-laravel-nginx-e-php-fpm-via-socket-unix-a7a69e39bfad?source=rss-b4ef76daff38------2</link>
            <guid isPermaLink="false">https://medium.com/p/a7a69e39bfad</guid>
            <category><![CDATA[php-fpm]]></category>
            <category><![CDATA[docker]]></category>
            <category><![CDATA[php]]></category>
            <category><![CDATA[nginx]]></category>
            <category><![CDATA[laravel]]></category>
            <dc:creator><![CDATA[Lincoln Biancardi]]></dc:creator>
            <pubDate>Sun, 16 Jul 2023 21:25:05 GMT</pubDate>
            <atom:updated>2023-07-16T21:31:36.172Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="Imagem de elefantes roxos fazendo analogia ao php andando em meio a containers fazendo analogia ao docker e orquestração de conteiners" src="https://cdn-images-1.medium.com/max/1024/1*4ivu-fy6ofMV0QNbZiDJJw.png" /></figure><p><strong>O que é este guia?</strong></p><p>Esse guia se propõe a explorar os detalhes de como configurar um ambiente seguro e eficiente usando Laravel, Nginx e PHP-FPM com sockets Unix. Apesar de se tratar de uma implementação básica da orquestração entre essas tecnologias, acredito que este guia pode te salvar caso esteja com problema para utilizar o laravel com php-fpm e nginx em produção.</p><p><strong>A motivação:</strong></p><p>A motivação para escrever este artigo vem da minha própria experiência. Durante a resolução de um problema, percebi que havia pouquíssimos artigos e guias online que falassem sobre essa específica configuração de php-fpm via socket unix. Passei dias tentando decifrar o problema e, ao final, então sozinho finalmente consegui resolver. E acredito que a compartilhar este conhecimento poderia ser útil para outros desenvolvedores que venham a passar pela mesma situação.</p><p>Então, se você está procurando uma maneira de otimizar o desempenho de sua aplicação PHP enquanto mantém a segurança, ou simplesmente tem curiosidade em entender mais sobre as diferenças entre sockets Unix e TCP utilizando o php-fpm, este artigo é para você. Estou na esperança de você não perder tanto tempo quanto eu, e poder focar em outros pontos importantes de sua aplicação ou de sua vida.</p><blockquote><em>É fundamental esclarecer que este tutorial não se propõe a oferecer as configurações mais otimizadas para Nginx e PHP-FPM, mas sim fornecer uma implementação básica e compreensível. Seu objetivo é ajudar a executar o Laravel com PHP-FPM via socket Unix e Nginx, oferecendo um ponto de partida para que cada um possa adaptar conforme suas necessidades específicas. Entenda este artigo como um primeiro passo em sua jornada com estas tecnologias e sinta-se encorajado a ajustar e experimentar com base no que você aprender aqui.</em></blockquote><p>Pré-requisitos:</p><ul><li><a href="https://getcomposer.org/">composer</a></li><li><a href="https://docs.docker.com/engine/install/ubuntu/">docker</a></li><li><a href="https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-compose-on-ubuntu-20-04">docker-compose</a> (somente se estiver usando uma versão abaixo da 20 do docker)</li></ul><h3>Então borá lá:</h3><h4>Etapa 1: Instalando o projeto</h4><p>Primeiro vamos criar um projeto laravel, ou você pode pular esta etapa caso queira usar essa configuração em seu projeto atual:</p><pre>composer create-project --prefer-dist laravel/laravel my_project_laravel</pre><h4>Etapa 2: Construindo a estrutura de pastas e arquivos necessários</h4><p>Agora vou sugerir uma estrutura de pastas para que nosso projeto funcione de forma parecida, vamos criar a pasta <strong>/infra</strong> e a estrutura final deve ficar parecida com isto:</p><pre>my_project_laravel/<br>│<br>└───infra/<br>│   │<br>│   ├───nginx/<br>│   │   ├───nginx.conf<br>│   │   └───vhost.conf<br>│   │<br>│   ├───php-fpm/<br>│   │   └───zz-docker.conf<br>│   │<br>│   ├───supervisor/<br>│   │   └───supervisord.conf<br>│   │<br>│   ├───Dockerfile<br>│   └───start.sh<br>│<br>├───app/<br>│   └───...<br>│<br>└───docker-compose.yml</pre><h4>Etapa 3: Escrevendo os conteúdos dos arquivos sugeridos acima</h4><p><strong>nginx.conf</strong></p><p>Este é o arquivo de configuração principal do Nginx. Ele define configurações de alto nível para o servidor Nginx.</p><pre># caminho: infra/nginx/nginx.conf<br>user  www-data;  # Define o usuário que irá rodar o processo do Nginx<br>worker_processes  1;  # Define a quantidade de processos de trabalho<br><br>error_log  /var/log/nginx/error.log warn;  # Define o caminho e o nível do log de erro<br>pid        /var/run/nginx.pid;  # Define o caminho do arquivo PID<br><br>events {<br>    worker_connections  1024;  # Define o número máximo de conexões simultâneas por processo de trabalho<br>}<br><br>http {<br>    include       /etc/nginx/mime.types;  # Inclui os tipos MIME conhecidos<br>    default_type  application/octet-stream;  # Define o tipo MIME padrão para o caso de não conseguir identificar o tipo do arquivo<br><br>    log_format  main  &#39;$remote_addr - $remote_user [$time_local] &quot;$request&quot; &#39;<br>                      &#39;$status $body_bytes_sent &quot;$http_referer&quot; &#39;<br>                      &#39;&quot;$http_user_agent&quot; &quot;$http_x_forwarded_for&quot;&#39;;  # Define o formato do log de acesso<br><br>    access_log  /var/log/nginx/access.log  main;  # Define o caminho do log de acesso<br><br>    sendfile        on;  # Habilita a transferência eficiente de arquivos<br>    #tcp_nopush     on;  # Comentado. Se ativado, poderia ajudar a enviar o arquivo completo em uma única resposta de rede<br><br>    keepalive_timeout  65;  # Define o tempo que a conexão ficará aberta esperando por novas requisições<br><br>    #gzip  on;  # Comentado. Se ativado, poderia ajudar a compactar a resposta, diminuindo o tráfego de rede<br><br>    include /etc/nginx/conf.d/*.conf;  # Inclui todos os arquivos .conf no diretório /etc/nginx/conf.d<br>}</pre><p><strong>vhost.conf</strong></p><p>Este é um arquivo de configuração do servidor virtual (vhost) do Nginx. Ele que vai definir a configuração para nossa aplicação laravel.</p><pre># caminho: infra/nginx/vhost.conf<br>server {<br>    listen 80;  # Configura o servidor para ouvir na porta 80<br>    index index.php index.html;  # Define a ordem de prioridade dos arquivos index<br>    server_name nginx;  # Define o nome do servidor<br>    error_log  /var/log/nginx/error.log;  # Define o caminho do log de erro<br>    access_log /var/log/nginx/access.log;  # Define o caminho do log de acesso<br>    root /var/www/public;  # Define o diretório raiz para a aplicação<br><br>    location / {<br>        try_files $uri $uri/ /index.php?$query_string;  # Redireciona todas as requisições para o Laravel<br>    }<br><br>    location ~ \.php$ {<br>        try_files $uri =404;  # Retorna 404 se o arquivo PHP não existir<br>        fastcgi_split_path_info ^(.+\.php)(/.+)$;  # Divide o caminho da requisição em SCRIPT_FILENAME (path+filename) e PATH_INFO (restante)<br>        fastcgi_pass unix:/var/run/php/php-fpm.sock;  # Configura a conexão para o PHP-FPM via socket Unix<br>        fastcgi_index index.php;  # Define o arquivo index para quando a URL terminar com /<br>        include fastcgi_params;  # Inclui os parâmetros adicionais para o FastCGI<br>        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  # Define o caminho completo para o script PHP<br>        fastcgi_param PATH_INFO $fastcgi_path_info;  # Define o PATH_INFO<br>    }<br>}</pre><p><strong>zz-docker.conf</strong></p><p>Este é um arquivo de configuração do PHP-FPM. Ele define a configuração para um pool de processos PHP-FPM.</p><blockquote><em>Aí você me pergunta: Mas por que esse nome engraçado? Bem, o PHP-FPM lê os arquivos de configuração em ordem alfabética. Então, chamamos nosso arquivo de zz-docker.conf para garantir que ele seja o último na lista. Assim, as configurações dele prevalecem sobre qualquer outra.</em></blockquote><pre>; caminho: infra/php-fpm/zz-docker.conf<br>[www]  ; Define o nome do pool PHP-FPM<br>user = www-data  ; Usuário que vai executar os processos PHP-FPM<br>group = www-data  ; Grupo que vai executar os processos PHP-FPM<br><br>listen = /var/run/php/php-fpm.sock  ; Define o caminho para o arquivo de socket Unix<br>listen.owner = www-data  ; Define o proprietário do arquivo de socket Unix<br>listen.group = www-data  ; Define o grupo do arquivo de socket Unix<br>listen.mode = 0660  ; Define as permissões do arquivo de socket Unix<br><br>pm = dynamic  ; Define o gerenciador de processos como dinâmico<br>pm.max_children = 5  ; Define o número máximo de processos filho que podem ser criados<br>pm.start_servers = 2  ; Define o número de processos filho que devem ser criados na inicialização<br>pm.min_spare_servers = 1  ; Define o número mínimo de processos filho em espera que devem estar disponíveis<br>pm.max_spare_servers = 3  ; Define o número máximo de processos filho em espera que podem existir</pre><p><strong>supervisord.conf</strong></p><p>E por último e não menos importante arquivo que cuida do supervisor em nossa estrutura de pastas /infra.</p><pre># caminho: infra/php-fpm/zz-docker.conf<br>[supervisord]<br>nodaemon=true  ; Roda o supervisord em primeiro plano<br>logfile=/var/log/supervisord.log  ; Caminho do log do supervisord<br>pidfile=/var/run/supervisord.pid  ; Caminho do arquivo pid do supervisord<br><br>[program:php-fpm]<br>command=/usr/local/sbin/php-fpm -F  ; Comando para iniciar o PHP-FPM<br>autostart=true  ; Inicia automaticamente o PHP-FPM quando o supervisord iniciar<br>autorestart=true  ; Reinicia automaticamente o PHP-FPM se ele falhar<br>stderr_logfile=/var/log/php/errors.log  ; Caminho do log de erro do PHP-FPM<br>stdout_logfile=/var/log/php/access.log  ; Caminho do log de acesso do PHP-FPM<br><br>[program:nginx]<br>command=/usr/sbin/nginx -g &#39;daemon off;&#39;  ; Comando para iniciar o Nginx<br>autostart=true  ; Inicia automaticamente o Nginx quando o supervisord iniciar<br>autorestart=true  ; Reinicia automaticamente o Nginx se ele falhar<br>stderr_logfile=/var/log/nginx/error.log  ; Caminho do log de erro do Nginx<br>stdout_logfile=/var/log/nginx/access.log  ; Caminho do log de acesso do Nginx</pre><p>Vamos bater um papo sobre o <strong>supervisord.conf</strong>. Esse arquivo é o chefão que garante que os nossos serviços de PHP-FPM e Nginx estão rodando de forma correta. O Supervisor é como um guarda-costas para nossos processos, sempre de olho para garantir que eles estejam funcionando como deveriam.</p><p>No nosso arquivo temos:</p><p><strong>[supervisord]</strong>: Essa parte é como a configuração geral do nosso segurança. Aqui falamos para ele não rodar em modo <a href="https://pt.wikipedia.org/wiki/Daemon_%28computa%C3%A7%C3%A3o%29">daemon</a> (por isso o nodaemon=true) e também dizemos onde guardar os arquivos de log e PID.</p><p><strong>[program:php-fpm]</strong>: Aqui damos as instruções para o nosso segurança sobre como lidar com o PHP-FPM. Dizemos como iniciar o serviço, que ele deve começar a trabalhar assim que o Supervisor iniciar e que, caso algo dê errado, ele deve colocar o PHP-FPM para rodar novamente. Ah, e também apontamos onde ficam os arquivos de log.</p><p><strong>[program:nginx]</strong>: Essa parte é igualzinha à do PHP-FPM, só que aqui estamos dando as instruções sobre o Nginx.</p><p>No final das contas, o nosso supervisord.conf faz com que o Supervisor seja o grande gerente dos nossos serviços, mantendo tudo nos trilhos!</p><p><strong>start.sh</strong></p><p>O start.sh é um script de inicialização criado para preparar o ambiente de execução do nosso contêiner antes de iniciar os serviços. Esse script é útil quando há tarefas de configuração a serem executadas antes do início dos serviços, como definir permissões de arquivo ou criar diretórios.</p><pre>#!/bin/bash<br># caminho: infra/start.sh<br>mkdir -p /var/log/php \<br>&amp;&amp; touch /var/log/php/errors.log \<br>&amp;&amp; chmod 777 /var/log/php/errors.log \<br>&amp;&amp; chown -R www-data:www-data /var/www/bootstrap/cache \<br>&amp;&amp; chown -R www-data:www-data /var/www/storage \<br>&amp;&amp; chown -R www-data:www-data /var/log/php \<br>&amp;&amp; mkdir -p /var/run/php \<br>&amp;&amp; chown -R www-data:www-data /var/run/php \<br>&amp;&amp; chmod -R 775 /var/www/storage<br><br>/usr/bin/supervisord -n -c /etc/supervisor/conf.d/supervisord.conf</pre><p><strong>Dockerfile</strong></p><p>Agora finalmente vamos criar um <strong>Dockerfile</strong> compátivel com <strong>laravel</strong>, <strong>php-fpm</strong> e <strong>nginx </strong>junto com nossa estrutura de pastas criada mais acima<strong>. </strong>Estou utilizando<strong> </strong>uma imagem do php-<strong>fpm8.1.2</strong>, mas sinta-se a vontade para utilizar a que você quiser, eu escolhi ela por questão de praticidade e segurança:</p><blockquote>Caso queira utilizar sua própria imagem atente-se se ela já tem o php-fpm, caso não tenha você precisará instar. E a parte importante é a <strong>Etapa 4 </strong>que você deve copiar para seu dockerfile para que funcione corretamente.</blockquote><pre># caminho: infra/Dockerfile<br><br># Etapa 1 - Define a imagem base<br># Estamos utilizando a imagem oficial do PHP com o servidor de processamento PHP-FPM na versão 8.1.2<br>FROM php:8.1.2-fpm<br><br># Define o diretório de trabalho dentro do container<br># Este diretório será a referência para os comandos que serão executados dentro do container<br>WORKDIR /var/www<br><br># Etapa 2 - Adiciona o instalador de extensões do PHP e instala as extensões necessárias<br># O script de instalação de extensões facilita a instalação de extensões do PHP dentro do container<br>ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/<br>RUN chmod +x /usr/local/bin/install-php-extensions &amp;&amp; sync &amp;&amp; \<br>    install-php-extensions intl mbstring sockets bcmath pdo_mysql zip exif pcntl gd memcached &amp;&amp; \<br>    apt-get update &amp;&amp; \<br>    apt-get install -y build-essential nginx supervisor wget git openssl libssl-dev procps htop libicu-dev &amp;&amp; \<br>    docker-php-ext-configure intl &amp;&amp; \<br>    docker-php-ext-install intl &amp;&amp; \<br>    wget -O /usr/local/bin/dumb-init https://github.com/Yelp/dumb-init/releases/download/v1.2.2/dumb-init_1.2.2_amd64 &amp;&amp; \<br>    chmod +x /usr/local/bin/dumb-init &amp;&amp; \<br>    apt-get clean &amp;&amp; rm -rf /var/lib/apt/lists/* <br><br># Etapa 3 - Baixa e instala o composer<br># O composer é o gerenciador de dependências do PHP<br>RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer<br><br># Etapa 4 - Copia o código da aplicação e configura a aplicação<br># Aqui estamos copiando os arquivos do host para o container, copiando arquivos de configuração para seus respectivos destinos e ajustando as permissões de diretórios e arquivos<br>COPY . /var/www<br>COPY .env.example ./.env<br>COPY infra/supervisor/supervisord.conf /etc/supervisor/conf.d/supervisord.conf<br>COPY infra/nginx/nginx.conf /etc/nginx/nginx.conf<br>COPY infra/nginx/vhost.conf /etc/nginx/sites-enabled/default<br>COPY infra/php-fpm/zz-docker.conf /usr/local/etc/php-fpm.d/zz-docker.conf<br>COPY infra/start.sh /start.sh<br>RUN chmod +x /start.sh<br><br># Expõe as portas 80 e 443 para permitir o tráfego de entrada no container<br>EXPOSE 80 443<br><br># Define o comando que será executado quando o container iniciar<br># Neste caso, estamos iniciando o supervisor, que irá gerenciar os processos do nginx e do php-fpm<br>CMD [&quot;/start.sh&quot;]</pre><p><strong>docker-compose.yml</strong></p><p>E por último vamos criar um <strong>docker-compose.yml</strong> para facilitar nosso manuseio com docker e desenvolvimento local:</p><p><em>Este arquivo cria dois serviços: </em><strong><em>Nginx </em></strong><em>e </em><strong><em>Api (nosso projeto laravel)</em></strong></p><pre># caminho: deve ser criado na raíz do projeto: docker-compose.yml<br>version: &quot;3&quot;  # Versão do Docker Compose utilizada.<br><br>services:  # Início da definição dos serviços do seu aplicativo.<br><br>  nginx:  # Nome do serviço nginx.<br>    image: nginx:1.25.1  # Imagem Docker que será usada para esse serviço.<br>    ports:<br>      - &quot;8000:80&quot;  # Mapeia a porta 80 do host para a porta 80 do container.<br>    volumes:  # Define volumes para persistir dados entre execuções do container.<br>      - ./infra/nginx/nginx.conf:/etc/nginx/nginx.conf  # Mapeia o arquivo nginx.conf do host para o container.<br>      - ./infra/nginx/vhost.conf:/etc/nginx/conf.d/default.conf  # Mapeia o arquivo vhost.conf do host para o container.<br>      - .:/var/www  # Mapeia o diretório atual do host para /var/www no container.<br>      - /var/run/php:/var/run/php  # Cria um volume para /var/run/php no container.<br>    depends_on:  # Define as dependências deste serviço.<br>      - api  # Este serviço depende do serviço &quot;api&quot;.<br><br>  api:  # Nome do serviço de nossa aplicação laravel.<br>    build:  # Especifica as opções de construção para a imagem do serviço.<br>      context: .  # Define o diretório de contexto para a construção da imagem.<br>      dockerfile: ./infra/Dockerfile<br>    container_name: api  # Define o nome do container.<br>    volumes:  # Define volumes, de forma similar ao serviço &quot;nginx&quot;.<br>      - ./infra/nginx/nginx.conf:/etc/nginx/nginx.conf<br>      - ./infra/nginx/vhost.conf:/etc/nginx/conf.d/default.conf<br>      - .:/var/www<br>      - /var/run/php:/var/run/php<br>    working_dir: /var/www  # Define o diretório de trabalho dentro do container.</pre><p>Agora vamos subir nosso ecossistema:</p><pre>docker compose up</pre><p>ou se tiver em uma versão mais antiga do docker:</p><pre>docker-compose up</pre><p>E como diz o mestre Akita, <strong>voilà!</strong></p><p>Você deve conseguir ver sua aplicação rodando em <a href="http://localhost:8000/">http://localhost:8000</a></p><p>Então aqui vai um desenho de como ficou nossa arquitetura no final:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/961/1*RIYD_R1pI97PTXhCCAx_rA.jpeg" /></figure><h3>Agradecimento</h3><p>Obrigado a todos que acompanharam até aqui! Esperamos que este artigo tenha sido útil e esclarecedor em sua jornada de desenvolvimento web, especificamente em relação ao uso de PHP-FPM e Nginx com o Laravel.</p><p>Entender essas tecnologias é fundamental para otimizar o desempenho e a segurança de seus aplicativos web PHP, e estou muito feliz em compartilhar esse conhecimento com você.</p><p>Este é apenas o começo. Planejo trazer mais conteúdos sobre como você pode melhorar ainda mais a performance e a segurança da sua aplicação Laravel ou PHP web usando PHP-FPM e Nginx. Portanto, fique de olho nos próximos artigos!</p><p>Se você encontrar algum problema ou tiver alguma dúvida sobre o conteúdo discutido aqui, não hesite em me procurar ou deixar um comentário. Estou à disposição para ajudar!</p><p>Muito obrigado por sua atenção e leitura! Até a próxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a7a69e39bfad" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>