PauloRB.dev

Desenvolvedor de Software

Como rodar Laravel no WSL com Valet Linux (de verdade) | PauloRB.dev Como rodar Laravel no WSL com Valet Linux (de verdade) – PauloRB.dev
Como rodar Laravel no WSL com Valet Linux (de verdade)

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:

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:

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:

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)

 

Mais Posts

Por que whereNull não funciona com updateOrCreate no Laravel (e como evitar bugs silenciosos)

Por que whereNull não funciona com updateOrCreate no Laravel (e como evitar bugs silenciosos)

O updateOrCreate() é um dos métodos mais utilizados no Eloquent para garantir que registros sejam atualizados ou criados sem duplicações.... Leia mais

Gerando Dados Fictícios para Análise de Compras em Python

Gerando Dados Fictícios para Análise de Compras em Python

Ao realizar estudos de análise de dados ou ao testar sistemas que lidam com grandes volumes de informações, é comum... Leia mais

Collections no PHP e seu uso no Laravel

Collections no PHP e seu uso no Laravel

Ao desenvolver aplicações modernas com PHP, uma das tarefas mais comuns é manipular arrays — filtrando, transformando ou agrupando dados.... Leia mais

Formas de Paginação de Dados no Laravel

Formas de Paginação de Dados no Laravel

No desenvolvimento de aplicações web, a paginação de dados é um recurso fundamental quando se trabalha com grandes volumes de... Leia mais