laravel

Laravel: Loguear errores y mensajes a archivo de log con Monolog

Aprendiendo a loguear errores y mensajes con Laravel 5.7

Hoy vamos a ver una cosa imprescindible en toda aplicación web: el logueo de mensajes o errores dentro de un log.

Laravel, el framework más poderoso de PHP (según yo), viene con el logueo de errores configurado por defecto y permite loguear errores de cualquier tipo en pocas líneas gracias a Monolog.

Anatomía de un mensaje de log en Laravel 5.7

Por cierto, si no quieres loguear con Laravel y quieres usar el lenguaje puro, mira este post: Loguear mensajes de error y debug a archivos con PHP.

Loguear un mensaje de debug con Laravel 5.7

Normalmente vamos a querer hacer esto en un controlador, aunque también se puede hacer desde cualquier otro lugar. Lo que hay que hacer es indicar que usaremos el espacio de nombres de Log, el cual es Illuminate\Support\Facades\Log.

Entonces lo indicamos en la parte superior así:

<?php # Esta línea es para que gist entienda la sintaxis de PHP
use Illuminate\Support\Facades\Log;

Después de eso podemos llamar a cualquier método estático de la clase Log.

Ejemplo de logueo con Laravel y Log

<?php
# Estamos dentro del controlador, si no logueas en el controlador no indiques el namespace
namespace App\Http\Controllers;
# Usar el namespace de Log
use Illuminate\Support\Facades\Log;

class AlgunControlador extends Controller
{

    public function algunaFuncion()
    {
      # Listo, aquí llama a Log::algunMetodo();
      Log::debug("Hola mundo, soy un mensaje de debug desde parzibyte.me");
      # También puedes pasar datos en forma de arreglo:
      $nombre = "Luis";
      Log::debug("Se está registrando un usuario", ["nombre" => $nombre]);
      # O usar var_export concatenando, aunque no lo recomiendo. Lee sobre var_export:
      # https://parzibyte.me/blog/2018/05/18/alternativa-var_dump-php-detalles-variable/
      $mascota = [
        "nombre" => "Maggie"
      ];
      Log::info("Tenemos una mascota: " . var_export($mascota, true));
    }
}

Así de simple es loguear y depurar con Laravel 5.7. Esto del log viene bien cuando hacemos peticiones AJAX y no podemos ver los errores en el navegador. Por ciert,

Si quieres la explicación más completa, sigue leyendo.

Niveles de logueo

Cuando escribimos en el log, hay niveles según la importancia. Podemos usar el log para mostrar mensajes de debug o incluso errores fatales. De hecho Laravel se fija en el entorno en el que se está y a partir de ello escribe o muestra los errores.

Los niveles, que a su vez son métodos de Log, son los siguientes:

<?php # Línea para que gist resalte la sintaxis
/**
* @author parzibyte
*/# Emergencia: el sistema está inutilizable
Log::emergency($mensaje);
# Alerta: se debe tomar acción de inmediato
Log::alert($mensaje);
# Crítico: condiciones críticas
Log::critical($mensaje);
# Error: condiciones de error
Log::error($mensaje);
# Advertencia: condiciones de advertencia o peligro
Log::warning($mensaje);
# Noticia: normal pero hay que prestarle atención
Log::notice($mensaje);
# Informativo: mensajes informativos
Log::info($mensaje);
# Debug: para depurar. Por ejemplo, imprimir el estado de una variable
Log::debug($mensaje);

Como ves, el nivel de emergencia es el “peor” y el de debug es el que menos importancia tiene en cuanto a la preocupación de verlo.

¿En dónde están los logs en Laravel?

Bueno, si exploramos la app en algún momento vamos a encontrar la ubicación de los mismos; pero no te preocupes, yo te digo en dónde se encuentran los archivos de log.

Los encuentras en la carpeta storage/logs. Ahí habrá archivos con extensión log dependiendo de la fecha. Por ejemplo, si hoy es 15 de enero del 2019 el archivo se llama laravel-2019-02-15.log.

Otras formas de loguear

Laravel proporciona más maneras de escribir mensajes de log, no solamente a archivos. Me parece que también puedes loguear a bases de datos u otros canales. Más información en la documentación oficial.

Te invito a leer más sobre Laravel en mi blog.

Estoy aquí para ayudarte 🤝💻


Estoy aquí para ayudarte en todo lo que necesites. Si requieres alguna modificación en lo presentado en este post, deseas asistencia con tu tarea, proyecto o precisas desarrollar un software a medida, no dudes en contactarme. Estoy comprometido a brindarte el apoyo necesario para que logres tus objetivos. Mi correo es parzibyte(arroba)gmail.com, estoy como@parzibyte en Telegram o en mi página de contacto

No te pierdas ninguno de mis posts 🚀🔔

Suscríbete a mi canal de Telegram para recibir una notificación cuando escriba un nuevo tutorial de programación.
parzibyte

Programador freelancer listo para trabajar contigo. Aplicaciones web, móviles y de escritorio. PHP, Java, Go, Python, JavaScript, Kotlin y más :) https://parzibyte.me/blog/software-creado-por-parzibyte/

Entradas recientes

Creador de credenciales web – Aplicación gratuita

Hoy te voy a presentar un creador de credenciales que acabo de programar y que…

2 semanas hace

Desplegar PWA creada con Vue 3, Vite y SQLite3 en Apache

Ya te enseñé cómo convertir una aplicación web de Vue 3 en una PWA. Al…

2 semanas hace

Arquitectura para wasm con Go, Vue 3, Pinia y Vite

En este artículo voy a documentar la arquitectura que yo utilizo al trabajar con WebAssembly…

2 semanas hace

Vue 3 y Vite: crear PWA (Progressive Web App)

En un artículo anterior te enseñé a crear un PWA. Al final, cualquier aplicación que…

2 semanas hace

Errores de Comlink y algunas soluciones

Al usar Comlink para trabajar con los workers usando JavaScript me han aparecido algunos errores…

2 semanas hace

Esperar promesa para inicializar Store de Pinia con Vue 3

En este artículo te voy a enseñar cómo usar un "top level await" esperando a…

2 semanas hace

Esta web usa cookies.