Xdebug no WordPress Studio

Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.

Xdebug é uma extensão de depuração para PHP que permite definir pontos de interrupção, inspecionar variáveis e percorrer seu código passo a passo. O WordPress Studio inclui suporte ao Xdebug, utilizando a versão WebAssembly do PHP do WordPress Playground.

Habilitando o Xdebug

1. Selecione o site que você deseja depurar.
2. Navegue até a aba Configurações.
3. Clique em “Editar site“.
4. Marque a caixa de seleção “Habilitar Xdebug“.
5. Clique em Salvar.

O site será reiniciado automaticamente com o Xdebug habilitado.

Limitações importantes

• Apenas um site por vez: O Xdebug só pode ser habilitado para um único site de cada vez. Para habilitá-lo em um site diferente, você precisa primeiro desabilitá-lo no site atual.
• Impacto no desempenho: O Xdebug pode deixar o site mais lento. Desabilite-o quando não estiver depurando ativamente.

Usando o Xdebug com sua IDE

Depois que o Xdebug estiver habilitado para um site, você pode conectar sua IDE (editor de código) para depurar plugins, temas e o código principal do WordPress.

Configuração do Visual Studio Code

1. Instale a extensão PHP Debug.
2. Crie um arquivo .vscode/launch.json no seu projeto com a seguinte configuração:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/wordpress": "${workspaceFolder}"
      }
    }
  ]
}

3. Defina breakpoints no seu código.
4. Inicie a sessão de depuração no Visual Studio Code (Executar → Iniciar Depuração).
5. Navegue até o seu site no navegador para acionar os breakpoints.

Configuração do PhpStorm

1. Vá para Settings (Configurações) → PHP → Debug (Depuração).
2. Verifique se a porta do Xdebug está definida como 9003.
3. Para parar de interromper na primeira linha:
   • Desative “Force break at first line when no path mapping specified” (Forçar interrupção na primeira linha quando nenhum mapeamento de caminho for especificado)
   • Desative “Force break at first line when a script is outside the project” (Forçar interrupção na primeira linha quando um script estiver fora do projeto)
4. Navegue até Settings (Configurações) -> PHP → Servers (Servidores) e configure o mapeamento para o servidor do seu site:
   • Host: localhost:8884
   • Port: 80
   • File directory: /Users/USERNAME/Studio/SITEDIR
   • Absolute path on the server: /wordpress
5. Ative “Start listening for PHP Debug Connections” (Começar a escutar conexões de depuração PHP) na barra de ferramentas.
6. Defina breakpoints no seu código.
7. Navegue até o seu site no navegador para acionar os breakpoints.

Saiba mais

Para informações adicionais sobre a integração com o Xdebug, consulte a documentação do Xdebug do WordPress Playground.