Pular para o conteúdo principal

Solucionar problemas e depurar

Revise os erros comuns​

  • Exija wp-load: para executar uma função PHP do WordPress usando a etapa runPHP, você precisará exigir wp-load.php. Portanto, o valor da chave code deve começar com "<?php require_once('wordpress/wp-load.php'); RESTO_DO_SEU_CÓDIGO".

Problemas e Soluções Comuns​

WP-CLI: Erro ao Estabelecer Conexão com Banco de Dados em Sites Montados​

Ao usar wp-cli com um site Playground montado (por exemplo, via --mount-before-install), você pode encontrar um erro "Erro ao estabelecer conexão com banco de dados". Isso acontece porque o WordPress Playground carrega o plugin de integração do banco de dados SQLite a partir de seus arquivos internos por padrão, não do diretório montado, significando que não é persistido para chamadas externas de wp-cli.

Para resolver isso, você precisa instalar e configurar explicitamente o plugin de integração do banco de dados SQLite dentro de seu Blueprint.

Solução: Adicione as seguintes etapas ao seu Blueprint:

Exemplo de Uso:

Para testar isso localmente, combine o Blueprint com seu comando Playground CLI:

Isso garantirá que o plugin SQLite seja instalado corretamente e configurado em seu site WordPress montado, permitindo que comandos wp-cli funcionem corretamente.

Construtor de Blueprints​

Você pode usar um editor de Blueprints no navegador para criar, validar e visualizar seus Blueprints.

Aviso

O editor está em desenvolvimento e o Playground incorporado às vezes falha ao carregar. Para contornar isso, atualize a página. Estamos cientes disso e trabalhando para melhorar a experiência.

Verificar o Sistema de Arquivos e Banco de Dados​

Algumas etapas de blueprint (como writeFile) alteram a estrutura interna do Sistema de Arquivos da instância Playground e outras (como runSql) alteram o banco de dados interno do WordPress.

Para verificar a estrutura final do sistema de arquivos interno e do banco de dados (após as etapas do blueprint terem sido aplicadas), podemos aproveitar alguns plugins WordPress que fornecem um gerenciador SQL e um explorador de arquivos como SQL Buddy e WPide (você pode vê-los em ação em https://playground.wordpress.net/?plugin=sql-buddy&plugin=wpide)

dica

Há vários métodos que podemos lançar a partir do console de qualquer instância do WordPress Playground para inspecionar os internos dessa instância. Eles são expostos como parte do objeto window.playground (veja Desenvolvedores > API JavaScript > Depuração e teste). Alguns exemplos:

A lista completa de métodos que podemos usar está disponível aqui

Verificar erros no console do navegador​

Se seu Blueprint não está sendo executado conforme esperado, abra as ferramentas de desenvolvedor do navegador para verificar se há erros.

Para abrir as ferramentas de desenvolvedor no Chrome, Firefox, Safari* e Edge: pressione Ctrl + Shift + I no Windows/Linux ou Cmd + Option + I no macOS.

cuidado

Se você ainda não fez isso, ative o menu Desenvolvimento: vá para Safari > Configurações... > Avançado e marque Mostrar recursos para desenvolvedores da web.

A janela de ferramentas de desenvolvedor permite inspecionar requisições de rede, visualizar logs do console, depurar JavaScript e examinar o DOM e estilos CSS aplicados à sua página. Isso é crucial para diagnosticar e corrigir problemas com Blueprints.

Registre suas próprias mensagens de erro​

Você pode usar error_log para suas próprias mensagens de erro através da etapa runPHP (veja exemplo de blueprint e demo ao vivo) e verifique-os através da opção "Ver Logs" ou do console do navegador.

Captura de tela de erros de log

informação

Quando você baixa sua instância do Playground como um zip através da opção "Baixar como zip", você também baixa o arquivo debug.log contendo todos os logs de sua instância do Playground.

Peça ajuda​

A comunidade está aqui para ajudar! Se você tem perguntas ou comentários, abra uma nova issue neste repositório. Lembre-se de incluir os seguintes detalhes:

  • O Blueprint que você está tentando executar.
  • A mensagem de erro que você está vendo, se houver.
  • A saída completa das ferramentas de desenvolvedor do navegador.
  • Qualquer outra informação relevante que possa nos ajudar a entender o problema: SO, versão do navegador, etc.