Laravel Debugbar: depurar a tua aplicação em desenvolvimento

A barra de depuração do Laravel é, antes de mais, um package criado por Barry vd. Heuvel que te permite acompanhar a aplicação de forma rápida e simples durante o desenvolvimento. Instala-se sem esforço e faz parte dos packages que vale mesmo a pena conhecer.

Instalação do package

A instalação da barra de depuração do Laravel é bastante simples: começamos com o composer e corremos o comando composer require para descarregar o package.

composer require barryvdh/laravel-debugbar

Em seguida, abre o ficheiro config/app.php e, dentro do array dos Providers, acrescenta:

Barryvdh\Debugbar\ServiceProvider::class,

Depois acrescentamos o respetivo alias no array das Facades:

'Debugbar' => Barryvdh\Debugbar\Facade::class,

E, por fim, não te esqueças de correr o comando seguinte:

php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

Pronto, a barra de depuração do Laravel está instalada e, enquanto a aplicação estiver em modo de depuração, a barra aparece e mostra estatísticas interessantes sobre a página que estás a ver.

Descobrir as várias opções

Eis a interface da famosa barra de ferramentas:

Mensagens

Messages é a secção que mostra as mensagens ou os testes que tenhas incluído num controlador, nos modelos, etc.

Debugbar::info("Message info !");
Debugbar::error('Message erreur!');
Debugbar::warning('Attention !');
Debugbar::addMessage('Mon Message', 'Mon Label');

As mensagens seguem os níveis PSR-3 (Emergency, Alert, Critical, Error, Warning, Notice, Info, Debug).

Timeline

A Timeline dá jeito para corrigir código que limita o desempenho da aplicação. Eis alguns exemplos:

Debugbar::startMeasure('render','Temps du rendu');
Debugbar::stopMeasure('render');

Debugbar::addMeasure('Lancement Laravel', LARAVEL_START, microtime(true));
Debugbar::measure('Total Utilisateurs', function() {
    $user = App\User::all();
});

Exceções

O separador seguinte regista as exceções. Podes registar exceções que passam a aparecer na barra de depuração:

try {
  throw new Exception('test');
} catch (Exception $e) {
  Debugbar::addException($e);
}

Views

As views mostram-te todos os templates pais e filhos com todos os parâmetros passados. Com este separador ficas seguro de que envias apenas os dados de que precisas:

return view('welcome')->with('titre', 'Mon Titre')->with('message', 'Mon Message');

Route

Pouco há a dizer, é bastante claro. O Route reúne todas as informações ligadas à rota: o controlador, o URI usado, o prefixo, o namespace, etc.

Query

As queries são uma das partes mais importantes de uma aplicação, e é neste separador que tens as informações sobre as consultas que envias ao servidor de base de dados. Consultas mal otimizadas ou desnecessárias conseguem alongar bastante o carregamento das páginas e prejudicar a experiência dos utilizadores.

Mail and Request

Estes dois elementos reúnem tudo o que precisas de saber sobre os e-mails enviados e os pedidos.

···