Usando Xdebug com Valet e WordPress

Embora eu não seja fã de usar estritamente  instruções var_dump ou echo como forma de depurar código, isso não significa que não haja momentos em que elas sejam úteis (caso contrário, elas não fariam parte da linguagem, certo ?).

Mas e se você estiver usando o Laravel Valet (que é fácil de configurar para o WordPress) e estiver tentando exibir uma matriz multidimensional e, em vez de obter uma saída bem formatada, acabar recebendo uma longa linha de texto no Times New Romano? As probabilidades são de que isso ocorre porque você não possui o Xdebug.

É bastante fácil de fazer, mas é baseado em algumas coisas diferentes. Além disso, depois de instalar o Xdebug, você também poderá usar um depurador com seu código. Esse não é o objetivo deste post, no entanto. 🙂

Obter toda essa configuração é bastante fácil, mas pressupõe o seguinte:

1. Você tem todas as constantes necessárias configuradas para depuração do WordPress,
2. Você tem o Homebrew instalado em sua máquina,
3. Você se sente confortável editando um arquivo de texto (tecnicamente, um arquivo de inicialização para o Xdebug, mas mesmo assim texto)
4. Você está bem reiniciando com manobrista.

Para ter certeza de que você configurou o WordPress para mostrar corretamente as mensagens de depuração, certifique-se de que wp-config.php (ou qualquer arquivo que mantenha suas constantes) tenha o seguinte :

Observe que existem outras constantes que você pode usar, mas essas são duas que normalmente sou fã de incluir no mínimo.

A partir daí, instale o Homebrew. É tão fácil quanto o comando a seguir, mas recomendo ler este artigo e a página inicial antes de executá-lo:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Uma vez feito, você precisará instalar o Xdebug. Isso pressupõe que você esteja executando o PHP 7.1. Caso contrário, você precisará instalar o pacote correto para sua versão do PHP. Mas supondo que isso seja preciso, emita o seguinte em seu terminal:

$ brew install php71-xdebug

Quando o Homebrew estiver pronto, use um editor de texto para carregar o arquivo de configuração do Xdebug. Para fazer isso, solte a seguinte linha no seu terminal:

$ atom /usr/local/etc/php/7.1/conf.d/ext-xdebug.ini

Em seguida, adicione as seguintes linhas :

[xdebug]
zend_extension="/usr/local/opt/php71-xdebug/xdebug.so"
xdebug.remote_enable=true
xdebug.remote_host=localhost
xdebug.remote_port=9000
xdebug.remote_handler=dbgp

Isso configurará o Xdebug, para que a saída do navegador seja legível e para que você possa usar coisas como o Xdebug para depurar seu código. Depois disso, para aproveitar o Xdebug com Valet e WordPress, você precisará reiniciar o Valet:

$ valet restart

E uma vez feito, você deve estar pronto para ir.