🚀 [Tutorial] Como adicionar o Xdebug no Laragon de forma simples

Se você trabalha com PHP no Laragon, sabe que ter o Xdebug configurado corretamente faz toda a diferença na hora de depurar aplicações.

Neste tutorial rápido, vou te mostrar como adicionar o Xdebug ao Laragon utilizando o método mais simples e seguro: phpinfo() + Xdebug Wizard.

🔎 O que é o Xdebug?

O Xdebug é uma extensão do PHP que permite:

• Debug passo a passo (breakpoints)

• Visualização de variáveis

• Stack trace detalhado

• Análise de performance

• Integração com VS Code, PHPStorm e outros editores

Se você desenvolve aplicações com frameworks como Laravel, CodeIgniter ou projetos PHP puros, o Xdebug é praticamente indispensável.

🛠️ Método 1: Usando phpinfo() + Xdebug Wizard (Recomendado)

Essa é a maneira mais fácil e segura de instalar o Xdebug no Laragon.

✅ Passo 1 – Obter o phpinfo()

No navegador, acesse:

👉 Copie todo o conteúdo da página (Ctrl + A → Ctrl + C).

✅ Passo 2 – Acessar o Xdebug Wizard

Agora acesse o site oficial:

🔗 https://xdebug.org/wizard.php

Cole o conteúdo do phpinfo() no campo disponível na página.

✅ Passo 3 – Analisar

Clique em:

Analyse my phpinfo() output

O Wizard vai identificar automaticamente:

• Versão do PHP

• Thread safety

• Architecture (x64 ou x86)

• Versão correta do Xdebug

Ele mostrará:

• O arquivo .dll correto para download

• Onde salvar

• O que adicionar no php.ini

✅ Passo 4 – Seguir as instruções

O Wizard fornecerá instruções como:

• Baixar o arquivo .dll

• Colocar dentro da pasta ext do PHP

• Adicionar linhas no php.ini

Normalmente algo como:

🔁 Atenção no último passo (Importante para Laragon)

O Wizard normalmente diz:

“4. Restart the webserver”

💡 No Laragon você NÃO precisa reiniciar manualmente o servidor.

Basta clicar no botão:

🔄 Reload

no painel do Laragon.

Isso já reinicia o Apache/Nginx e o PHP.

🧪 Como verificar se o Xdebug está funcionando

Depois de recarregar o Laragon:

• Acesse novamente phpinfo()

• Procure por Xdebug

Se aparecer uma seção chamada Xdebug, está tudo funcionando 🎉