Tracy
Tracy é um incrível manipulador de erros que pode ser usado com Flight. Possui vários painéis que podem ajudá-lo a depurar sua aplicação. É também muito fácil de estender e adicionar seus próprios painéis. A equipe do Flight criou alguns painéis especificamente para projetos do Flight com o plugin flightphp/tracy-extensions.
Instalação
Instale com o compositor. E na verdade, você vai querer instalar isso sem a versão de desenvolvimento, já que o Tracy vem com um componente de tratamento de erros de produção.
composer require tracy/tracy
Configuração Básica
Existem algumas opções de configuração básicas para começar. Você pode ler mais sobre elas na Documentação do Tracy.
require 'vendor/autoload.php';
use Tracy\Debugger;
// Habilitar Tracy
Debugger::enable();
// Debugger::enable(Debugger::DEVELOPMENT) // às vezes você precisa ser explícito (também Debugger::PRODUCTION)
// Debugger::enable('23.75.345.200'); // você também pode fornecer um array de endereços IP
// Aqui é onde os erros e exceções serão registrados. Certifique-se de que este diretório exista e seja gravável.
Debugger::$logDirectory = __DIR__ . '/../log/';
Debugger::$strictMode = true; // exibir todos os erros
// Debugger::$strictMode = E_ALL & ~E_DEPRECATED & ~E_USER_DEPRECATED; // todos os erros exceto avisos obsoletos
if (Debugger::$showBar) {
$app->set('flight.content_length', false); // se a barra do Debugger estiver visível, então o comprimento do conteúdo não pode ser definido pelo Flight
// Isso é específico para a Extensão do Tracy para o Flight se você incluiu isso
// caso contrário, comente isso.
new TracyExtensionLoader($app);
}
Dicas Úteis
Ao depurar seu código, existem algumas funções muito úteis para exibir dados para você.
bdump($var)
- Isso irá despejar a variável na Barra do Tracy em um painel separado.dumpe($var)
- Isso irá despejar a variável e então cessar imediatamente.