Skip to content

Início / Tutoriais / VS Code e Git

Xdebug

O Xdebug é uma ferramenta de debug para PHP que permite inspecionar o estado da aplicação em tempo real. Abaixo teremos a explicação de como instalar, configurar e utilizar o Xdebug no VS Code.

Instalar Xdebug

  1. Instalar o plugin PHP Debug

Xdebug - 1

  1. Abrir um ficheiro PHP aleatório
  2. Ir ao Menu lateral de Debug (Ctrl + Shift + D)
  3. Carregar em "create a launch.json file"
  4. Gravar e fechar o ficheiro criado.

Usar Xdebug

Para iniciar o Xdebug, basta carregar em F5 e aparece a barra de controlo do Xdebug:

Xdebug - 2

Podemos personalizar onde queremos que o Xdebug pare:

Xdebug - 3

Neste caso, coloquei todos os Erros, Excepções e um breakpoint no ficheiro hotel_list.php

Para colocar os breakpoints basta colocar o ponto ao lado esquerdo do número da linha:

Xdebug - 4

Quando a aplicação atinge um dos breakpoints, o VS Code começa a piscar, para o processo de PHP e mostra a informação deste modo:

Xdebug - 5

Neste momento temos vários comandos que podemos correr para prosseguir com o debug:

  • F5 - Continua o processo

  • F10 - Próximo passo do processo

  • F11 - Entrar na função

  • Shift + F11 - Sair da função

Todas estas opções estão disponíveis na barra de controlo do Xdebug.


(Última atualização: 28/07/2025)