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

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.

ip addr show eth0 | grep inet

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)