Registro en aplicaciones PHP: mejores prácticas para principiantes

Registro en aplicaciones PHP: mejores prácticas para principiantes

El registro es el proceso de escribir información sobre el funcionamiento de una aplicación en archivos especiales (logs). Para los desarrolladores principiantes de PHP, saber cómo configurar correctamente el registro es tan importante como conocer la sintaxis del lenguaje. Los logs ayudan a:

\n
• Detectar errores que no son visibles en pantalla (por ejemplo, en un entorno de producción).
\n
• Rastrear el comportamiento de los usuarios y el funcionamiento del sistema.
\n
• Realizar auditorías de seguridad.
\n
• Acelerar la depuración de errores complejos.
\n

En este artículo, analizaremos las mejores prácticas de registro en PHP: desde la función incorporada error_log() hasta el uso de bibliotecas profesionales como Monolog. Aprenderá a no saturar el código, a elegir correctamente los niveles de registro y a evitar errores típicos de principiantes.

1. Fundamentos: registro incorporado en PHP

La forma más sencilla de escribir algo en un log es usar la función error_log(). Puede enviar mensajes al log del sistema del servidor, a un archivo específico o por correo electrónico.

Ejemplo de registro básico

<?php\n// Escritura en el log del sistema (syslog)\nerror_log('Este es un mensaje de error');\n\n// Escritura en un archivo específico\nerror_log('Error de conexión a la BD', 3, '/var/log/my_app_errors.log');\n?>

Ventajas: no requiere instalar bibliotecas, funciona "de fábrica".

Desventajas:

\n
• Sin flexibilidad (no se puede cambiar fácilmente el formato de salida).
\n
• Difícil de filtrar por nivel de importancia.
\n
• Incómodo al trabajar con múltiples canales (archivo, base de datos, Slack).
\n

Para scripts simples y aprendizaje, esto es suficiente, pero para proyectos serios es mejor usar soluciones más avanzadas.

2. Niveles de registro: cuándo y qué escribir

Para que los logs sean útiles y no "ruido", es importante clasificar los mensajes por nivel de gravedad. El estándar PSR-3 (que analizaremos a continuación) propone 8 niveles:

\n
• DEBUG — información de depuración (valores de variables, tiempo de ejecución). Se usa solo en la etapa de desarrollo.
\n
• INFO — mensajes informativos (usuario registrado, solicitud procesada).
\n
• NOTICE — eventos normales pero importantes (uso de una API obsoleta).
\n
• WARNING — advertencias (algo salió mal, pero la aplicación continúa funcionando, por ejemplo, formato de entrada incorrecto).
\n
• ERROR — errores que requieren intervención (no se pudo guardar el archivo).
\n
• CRITICAL — errores críticos (un componente principal del sistema no está disponible).
\n
• ALERT — requiere acción inmediata (intrusión, fallo de la base de datos).
\n
• EMERGENCY — el sistema no funciona.
\n

Ejemplo de uso de niveles (sin bibliotecas)

<?php\nfunction logMessage($level, $message) {\n    $logFile = __DIR__ . '/app.log';\n    $timestamp = date('Y-m-d H:i:s');\n    $formatted = "[{$timestamp}] [{$level}] {$message}" . PHP_EOL;\n    file_put_contents($logFile, $formatted, FILE_APPEND);\n}\n\nlogMessage('INFO', 'El usuario inició sesión');\nlogMessage('ERROR', 'No se pudo conectar a la base de datos');\n?>

Consejo: Nunca escriba contraseñas, tokens o consultas SQL completas con datos de usuario en los logs; esto es un riesgo de seguridad.

3. PSR-3 y Monolog: enfoque profesional

PSR-3 es una recomendación de PHP-FIG que describe una interfaz unificada para bibliotecas de registro. La implementación más popular de PSR-3 es Monolog. Se utiliza en Laravel, Symfony y muchos otros frameworks.

Instalación de Monolog mediante Composer

composer require monolog/monolog

Ejemplo simple con Monolog

<?php\nrequire 'v