syslog

(PHP 3, PHP 4, PHP 5)

syslog -- Generar un mensaje de registro de sistema

Descripción

bool syslog ( int prioridad, string mensaje )

syslog() genera un mensaje de registro que será distribuido por el registro del sistema. prioridad es una combinación del recurso y el nivel, cuyos valores son dados en la siguiente sección. El argumento restante es el mensaje a enviar, excepto que los dos caracteres %m serán reemplazados por la cadena del mensaje de error (strerror) correspondiente al valor presente de errno.

Tabla 1. Prioridades de syslog() (en orden descendiente)

ConstanteDescripción
LOG_EMERGel sistema es inutilizable
LOG_ALERTdebe tomarse una acción inmediatamente
LOG_CRITcondiciones críticas
LOG_ERRcondiciones de error
LOG_WARNINGcondiciones de advertencia
LOG_NOTICEcondición normal, pero significativa
LOG_INFOmensaje informativo
LOG_DEBUGmensaje de nivel de depuración

Ejemplo 1. Uso de syslog()

<?php
definir_variables_syslog
();
// abrir syslog, incluir el ID de proceso y enviar
// el registro a la salida de error estandar, usar
// tambien un mecanismo de registro definido por el
// usuario
openlog("registroDeMiScript", LOG_PID | LOG_PERROR, LOG_LOCAL0);

// codigo cualquiera

if (cliente_autorizado()) {
    
// hacer algo
} else {
    
// cliente no autorizado!
    // registrar el intento
    
$acceso = date("Y/m/d H:i:s");
    
syslog(LOG_WARNING, "Cliente no autorizado: $acceso $_SERVER[REMOTE_ADDR] ($_SERVER[HTTP_USER_AGENT])");
}

closelog();
?>
Información sobre la forma de preparar un gestor de registro definido por el usuario puede encontrarse en la página de manual Unix para syslog.conf(5). Más información sobre los recursos y opciones de syslog puede encontrarse en las páginas man para syslog(3) en máquinas Unix.

En Windows NT, el servicio syslog es emulado usando el Registro de Eventos.

Nota: El uso de los valores LOG_LOCAL0 a LOG_LOCAL7 para el parámetro recurso de openlog() no está disponible en Windows.

Vea también define_syslog_variables(), openlog() y closelog().