Rastrear bugs no desenvolvimento do WordPress muitas vezes parece como procurar uma agulha em um palheiro. Especialmente quando você está dependendo de chamadas var_dump() e verificando manualmente os logs de erro.

O WordPress Studio tem duas novas funcionalidades de depuração que tornam esse processo mais rápido e intuitivo: suporte a Xdebug e acesso ao log de depuração.

Experimente o WordPress Studio gratuitamente

Depuração passo a passo com Xdebug

Xdebug é a extensão de depuração PHP padrão de ouro. Em vez de espalhar a saída de depuração pelo seu código, você pode definir pontos de interrupção, avançar na execução linha por linha e inspecionar variáveis em tempo real — tudo a partir do seu editor.

Isso agora está disponível para todos os usuários do Studio e é alimentado pela versão WebAssembly do PHP do WordPress Playground, o que significa que não há nada extra para instalar ou configurar no nível do sistema.

Habilitando o Xdebug

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

O Studio reiniciará o site automaticamente com o Xdebug ativo.

A página de configurações para habilitar o Xdebug no WordPress Studio

Algumas coisas que vale a pena lembrar:

  • O Xdebug só pode estar ativo para um único site: Para usar o Xdebug em um site diferente, desative-o primeiro no que está ativo atualmente. O site com o Xdebug habilitado exibirá um ícone de bug na barra lateral esquerda.
  • Habilitar o Xdebug vai desacelerar as coisas de forma perceptível: É melhor ativá-lo apenas quando você estiver depurando ativamente.

Conectando seu IDE

Uma vez que o Xdebug está habilitado, você pode conectar seu editor e começar a depurar para encontrar a origem de quaisquer problemas — plugins, temas ou o núcleo do WordPress. O Studio escuta por conexões de depuração na porta 9003.

Para o guia completo de configuração, veja a documentação do Xdebug no Studio.

Acesso mais fácil aos logs de depuração

Às vezes, um depurador completo é mais do que você precisa quando só quer ver o que o WordPress está registrando.

O Studio agora torna isso muito mais fácil com um botão dedicado para o log de depuração, que define WP_DEBUG e WP_DEBUG_LOG para seus sites automaticamente.

Habilitando o log de depuração no Studio

  1. Selecione seu site e clique em Editar site.
  2. Abra a aba Depuração.
  3. Ative a opção Habilitar log de depuração.
  4. Clique em Salvar.

Quando o log de depuração está habilitado, seu site local irá capturar erros, avisos e notificações PHP em um arquivo de log em wp-content/debug.log. Você verá um link Abrir arquivo de log aparecer na aba Configurações, que abre o log diretamente — sem necessidade de procurar manualmente o caminho do arquivo.

Você também pode escrever suas próprias mensagens no log usando a função error_log() do PHP:

error_log( 'Meu valor: ' . print_r( $my_variable, true ) );

Isso é especialmente útil quando você precisa de uma olhada rápida no que está acontecendo durante a ativação de um plugin, um callback de hook ou uma requisição da API REST — sem configurar uma sessão de depuração completa.

Usando agentes de IA para interpretar logs de depuração

Uma vez que seu log de depuração está capturando erros e avisos, você pode trazer um agente de IA diretamente para o seu fluxo de trabalho de depuração. Em vez de ler manualmente a saída do log e cruzar referências com a documentação, aponte seu agente para o log e deixe que ele faça o trabalho pesado.

Seja usando Claude Code, Cursor ou Codex, a configuração é a mesma: diga ao seu agente que os logs de erro estão disponíveis em wp-content/debug.log. A partir daí, ele pode ler a saída, identificar o que está dando errado e sugerir correções, tudo sem interromper seu fluxo.

Mostrando erros no navegador

A aba Depuração também inclui uma opção “Mostrar erros no navegador”, que define WP_DEBUG_DISPLAY e controla se os erros PHP são impressos diretamente na página em vez de serem capturados silenciosamente no log.

Quando ativado, erros fatais, avisos e notificações aparecem inline na saída HTML — útil durante o desenvolvimento ativo para que você não precise ficar alternando para o arquivo de log.

Uma nota importante: “Mostrar erros no navegador” é melhor usado junto com o log de depuração, não como um substituto. É ótimo para iterações rápidas no seu próprio ambiente local, mas você vai querer mantê-lo desativado em qualquer site que seja compartilhado com clientes — pode expor informações sensíveis de caminho ou lógica interna na saída da página.

Melhor depuração, correções mais rápidas

Essas duas funcionalidades abordam diferentes partes do seu fluxo de trabalho de depuração local:

  • O log de depuração oferece uma maneira leve de capturar erros e avisos à medida que acontecem.
  • Xdebug leva isso adiante, permitindo que você pause a execução e investigue exatamente o que está acontecendo dentro do seu código.

Juntas, elas tornam o Studio um ambiente mais capaz para desenvolver e resolver problemas em sites WordPress localmente.

Se você ainda não experimentou o WordPress Studio, agora é um ótimo momento para começar.

Experimente o WordPress Studio gratuitamente