🚀 [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
.dllcorreto 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
extdo 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 🎉