Depuração no Studio

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

O WordPress Studio inclui diversas ferramentas integradas para ajudar você a encontrar e corrigir problemas nos seus sites WordPress locais — sem precisar instalar softwares adicionais ou sair do aplicativo.

Log de depuração

Às vezes, você só precisa ver o que o WordPress está registrando. O Studio facilita isso com um botão dedicado de log de depuração que configura o WP_DEBUG e o WP_DEBUG_LOG para o seu site automaticamente.

Ativando o log de depuração

1. Selecione o site que você deseja depurar.
2. Navegue até a aba Configurações.
3. Clique em “Editar site“.
4. Abra a aba Depuração.
5. Ative a opção Habilitar log de depuração.
6. Clique em Salvar.

Quando o log de depuração está ativado, o seu site captura erros, avisos e notificações do PHP no arquivo wp-content/debug.log. Um link Abrir arquivo de log aparecerá na aba Configurações, para que você possa acessar o arquivo diretamente sem precisar procurar pelo caminho.

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

error_log( 'My value: ' . print_r( $my_variable, true ) );

Exibir erros no navegador

A aba Depuração também inclui um botão Mostrar erros no navegador, que define WP_DEBUG_DISPLAY. Quando ativado, erros e avisos do PHP são exibidos diretamente na saída da página, em vez de serem capturados silenciosamente no arquivo de log — útil quando você quer feedback imediato durante o desenvolvimento ativo.

Tenha em mente:

• Mostrar erros no navegador funciona melhor junto com o log de depuração, não como substituto dele.
• Desative essa opção em qualquer site que você compartilhe com clientes — ela pode expor informações de caminhos internos ou outros detalhes de implementação na saída da página.

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

Quando seu log de depuração estiver ativo, você pode direcionar um agente de IA diretamente para ele. Diga ao seu agente — seja usando Claude Code, Cursor ou outra ferramenta — 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á errado e sugerir correções sem interromper seu fluxo de trabalho.

Acesso ao banco de dados com phpMyAdmin

Inspecionar ou editar seu banco de dados local costumava exigir uma ferramenta separada e uma configuração à parte. O Studio inclui acesso ao phpMyAdmin diretamente na aba Visão geral — assim você pode consultar tabelas, verificar dados e depurar problemas de esquema sem sair do aplicativo ou configurar qualquer coisa.

Para abrir o phpMyAdmin de um site, selecione o site e clique no botão phpMyAdmin na aba Visão geral.

Depuração passo a passo com Xdebug

Para investigações mais profundas, o Studio inclui suporte ao Xdebug. Em vez de espalhar saídas de depuração pelo seu código, você pode definir breakpoints, percorrer a execução linha por linha e inspecionar variáveis em tempo real — tudo a partir do seu editor.

O Xdebug está disponível para todos os sites do Studio e não requer instalação no sistema. O Studio escuta conexões de depuração na porta 9003.

Para instruções completas de configuração, incluindo como conectar o VS Code e o PhpStorm, consulte Xdebug no Studio.