Cómo implementar una barra de depuración de PHP en Laravel 5.4

Hoy en día el proceso de depuración en muchos proyectos web no es tan doloroso como hace un par de años, con el tiempo se realizan mejoras en todo para ayudar al desarrollador a preocuparse por lo que realmente importa, su proyecto y no cómo funciona la tecnología que está usando. Symfony Framework implementa por defecto una útil barra de depuración:

Eso lo ayuda en situaciones terribles sobre problemas con su base de datos, funcionalidades obsoletas, un volcador de variables adicional para volcar variables en la barra para no contaminar sus vistas y muchas otras características útiles. También hay bibliotecas PHP simples que implementan un depurador personalizado como Kint, sin embargo, no son totalmente adecuadas (funcionan bastante bien) para su marco porque necesitaría modificar la forma en que trabaja. Si está dispuesto a implementar una barra tan útil en su Proyecto Laravel, puede utilizar un proyecto especial para este marco que le ayudará a implementar la barra de depuración en un par de segundos.

1. Instale el paquete laravel-debugbar

El paquete Laravel Debugbar le permite implementar una barra de depuración simple en su proyecto Laravel con diferentes secciones. Incluye un ServiceProvider para registrar la barra de depuración y adjuntarla a la salida. Puede publicar activos y configurarlos a través de Laravel. Inicia algunos recopiladores para trabajar con Laravel e implementa un par de DataCollectors personalizados, específicos para Laravel. Está configurado para mostrar Redirects y (jQuery) Ajax Requests.

Para instalar este paquete, ejecute el siguiente comando en composer:

composer require barryvdh/laravel-debugbar:~2.4

Como se mencionó al comienzo del artículo, nos centraremos en la versión 5.4 de Laravel, por lo que debe usar la versión 2.4 de la biblioteca. Para obtener más información sobre esta biblioteca, visite el repositorio oficial en Github aquí.

2. Registre el proveedor de servicios y el alias

Después de la instalación de la biblioteca, podrá usar sus clases a través del cargador automático de composer. Registre el servicio que proporciona la barra de depuración en el your-project/config/app.phparchivo en la propiedad de proveedores de la matriz devuelta. Si lo desea, puede registrar un alias para la clase del depurador para que pueda agregar mensajes a la barra de depuración en el mismo archivo:

<?php

return [
    /* Rest of app.php */

    'providers' => [
        // Register Debug Bar Service Provider
        Barryvdh\Debugbar\ServiceProvider::class,
    ],

    /* Rest of app.php */

    'aliases' => [
        // Register Debugbar alias
        'Debugbar' => Barryvdh\Debugbar\Facade::class,
    ],
];

3. Usando la barra de depuración

El generador de perfiles está habilitado de forma predeterminada, si tiene APP_DEBUG = true. Puede anular eso en la configuración (debugbar.enabled) o configurando DEBUGBAR_ENABLED en su .env. Ver más opciones en config / debugbar.php También puede establecer en su configuración si desea incluir / excluir los archivos del proveedor también (FontAwesome, Highlight.js y jQuery). Si ya los usa en su sitio, configúrelo como falso. También puede mostrar solo los proveedores js o css, configurándolo en 'js' o 'css'. (Highlight.js requiere css + js, por lo tanto, establézcalo en verdadero para resaltar la sintaxis). Para probarlo, puede intentar usar el método de depuración de Laravel y luego agregar un mensaje al registrador con la barra de depuración para mostrarlo en caso de que no aparezca:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Debugbar;

class DefaultController extends Controller
{
    /**
    * Index route
    *
    * @return Response
    */
    public function index()
    {
        dump("Hello !");
        
        Debugbar::info("Hello World !");

        // Haz lo que tengas que hacer con los datos de la solicitud
        return view('default', array(

        ));
    }
}

Que te diviertas ❤️!