← voltar
Laravel NGINX php Tutorial

Como rodar Laravel no WSL com Valet Linux (de verdade)

Paulo Bolsanello ·20 Jul 2025 ·2 min de leitura
Como rodar Laravel no WSL com Valet Linux (de verdade)
Sim, dá pra desenvolver Laravel no Windows sem sofrer. Mas você precisa fazer do jeito certo: usando WSL + Valet Linux. Esqueça XAMPP, Laragon, Docker lento e até o WSL 1. O caminho mais fluido para trabalhar com Laravel no Windows hoje é rodar o ambiente nativamente no Linux, dentro do Windows, com o poder do Valet. Spoiler: no final você acessa http://meusite.test no Chrome como se estivesse no Linux nativo. E funciona rápido.

Pré-requisitos

  • Windows 10/11

  • WSL2 habilitado

  • Ubuntu instalado no WSL

  • PHP 8.3+

  • Composer

  • Git

Se não tem isso ainda, instala o WSL aqui primeiro.

1. Instalando o Valet Linux

composer global require cpriego/valet-linux

Adicione o bin do composer ao seu PATH no ~/.bashrc ou ~/.zshrc:

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

Depois rode:

valet install

Erro? Provavelmente ele pediu algumas dependências. Instala elas:

sudo apt install jq xsel libnss3-tools -y

E instala o NGINX também, caso não esteja:

sudo apt install nginx dnsmasq -y

Aí sim:

valet install

2. Criando e servindo seus projetos Laravel

Crie uma pasta para seus projetos:

mkdir ~/Desenvolvimento
cd ~/Desenvolvimento
valet park

Agora crie ou clone seu projeto:

laravel new corretagem-novo
cd corretagem-novo
valet link

Acesse:

http://corretagem-novo.test

Sim. .test funcionando, direto no navegador do Windows.

3. “DNS_PROBE_FINISHED_NXDOMAIN”? É o WSL… Você precisa mapear o domínio .test para o IP do WSL no Windows. No terminal WSL: 
ip addr show eth0 | grep inet
Vai dar algo como: 
inet 172.28.81.23/20 ...

Copie o IP.

Agora, no Windows, edite o arquivo hosts como administrador:

C:\Windows\System32\drivers\etc\hosts

Adicione:

172.28.81.23  corretagem-novo.test

Bonus: Dicas rápidas

  • valet use 8.2>=: troca a versão do PHP

  • valet secure meuapp: ativa HTTPS pro projeto

  • valet tinker: shell PHP direto

  • valet share: ngrok instantâneo (para mostrar o projeto ao cliente)

 

Comentários (0)

Nenhum comentário ainda. Seja o primeiro.

Continue lendo