Registro en PHP: mejores prácticas para principiantes

Introducción: ¿Por qué es necesario el registro en PHP?

El registro no es solo escribir errores en un archivo. Es su principal herramienta para monitorear, depurar y analizar el funcionamiento de una aplicación web. Sin un registro de calidad, estará adivinando por qué el sitio se cayó o por qué un usuario no puede realizar un pedido. Para los desarrolladores principiantes en PHP, configurar un registro adecuado es el primer paso hacia el desarrollo profesional.

Imagine que su aplicación es una caja negra. Los registros son la única forma de mirar dentro, entender qué sucede en cada momento. En este artículo, analizaremos las mejores prácticas que le ayudarán a evitar los errores típicos de los principiantes y construir un sistema de monitoreo confiable.

1. Fundamentos: funciones integradas de PHP para el registro

PHP proporciona varias funciones integradas para trabajar con registros. La más simple y popular es error_log(). Permite enviar un mensaje al registro del sistema del servidor o a un archivo específico.

Ejemplo básico de uso de error_log()

// Escritura muy simple de un error en el registro del sistemaerror_log("Este es un mensaje de error", 0);

// Escritura en un archivo específicoerror_log("Error de conexión a la base de datos", 3, "/var/log/php_errors.log");

// Escritura especificando el tipo de mensajeerror_log("Advertencia: consulta lenta", 4);

Sin embargo, usar error_log() directamente en producción no es la mejor idea. Primero, mezcla diferentes tipos de mensajes. Segundo, es difícil gestionar el formato y la rotación de los registros. Para proyectos serios, es mejor usar bibliotecas especializadas.

Configuración de php.ini para un registro mejorado

Antes de escribir código, asegúrese de que su php.ini esté configurado correctamente:

; Habilitamos el registro de erroreslog_errors = On; Ruta al archivo de registroerror_log = /var/log/php_errors.log; Tamaño máximo del registro (en bytes)log_errors_max_len = 1024; Desactivamos la visualización de errores en pantalla (para producción)display_errors = Off; Habilitamos el registro de todos los niveles de errorerror_reporting = E_ALL

2. Niveles de registro: desde DEBUG hasta CRITICAL

Uno de los principales errores de los principiantes es registrar todos los mensajes en un solo montón. El registro profesional utiliza niveles de gravedad. Esto ayuda a filtrar rápidamente los registros y no pasar por alto errores críticos entre los mensajes informativos.

Niveles estándar PSR-3

La comunidad PHP adoptó el estándar PSR-3, que define 8 niveles de registro:

• DEBUG — información detallada de depuración (se usa solo en desarrollo)
• INFO — mensajes informativos (usuario registrado, pedido creado)
• NOTICE — eventos normales pero significativos (uso de funciones obsoletas)
• WARNING — advertencias (por ejemplo, consulta lenta, poco espacio disponible)
• ERROR — errores que requieren atención (no se pudo conectar a la BD)
• CRITICAL — errores críticos (componente principal del sistema no disponible)
• ALERT — requiere intervención inmediata (intrusión, fallo del sistema)
• EMERGENCY — el sistema no funciona

Ejemplo de implementación de niveles con Monolog

La mejor biblioteca para el registro en PHP es Monolog. Cumple completamente con PSR-3 y es fácil de configurar:

use Monolog\\Logger;use Monolog\\Handler\\StreamHandler;use Monolog\\Handler\\RotatingFileHandler;use Monolog\\Level;

// Creamos un logger con nombre de canal$log = new Logger('app');

// Agregamos un manejador para todos los niveles$log->pushHandler(new StreamHandler('/var/log/app.log', Level::Debug));

// Archivo separado para errores críticos$log->pushHandler(    new RotatingFileHandler('/var/log/critical.log', 30, Level::Critical));

// Y