syslog

(PHP 4, PHP 5)

syslog — Genera un mensaje log de sistema

Descripción

bool syslog ( int $priority , string $message )

syslog() genera un mensaje log que será distribuido por el logger del sistema.

Para información de como configurar un usuario definido como controlador del log, ver syslog.conf (5) del manual de Unix. Más información sobre los recursos y opciones de syslog pueden encontrarse en las páginas del manual de syslog (3) en entornos Unix.

Parámetros

priority

priority es una combinación del tipo y el nivel. Posibles valores:
Prioridades syslog() (en orden descendente)
Constante Descripción
LOG_EMERG sistema inservible
LOG_ALERT se debe tomar acción de forma inmediata
LOG_CRIT condiciones críticas
LOG_ERR condiciones de error
LOG_WARNING condiciones de alerta
LOG_NOTICE condición normal, pero relevante
LOG_INFO mensaje de información
LOG_DEBUG mensaje de testeo

message

El mensaje a enviar a excepción de dos caracteres %m serán reemplazados con el mensaje de error (strerror) correspondiente con el valor presente de errno.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Uso de syslog()

<?php
// abre syslog, incluyendo el ID del proceso. También envia al
// log el error estándar y el mecanismo de logging
// definido por el usuario
openlog("myScriptLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);

// algún código

if (authorized_client()) {
    // hace algo
} else {
    // Cliente no autorizado!
    // Se logea el intento
    $access = date("Y/m/d H:i:s");
    syslog(LOG_WARNING, "Cliente no autorizado: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");
}

closelog();
?>

Notas

En Windows NT, el servicio syslog es emulado usando el Event Log.

Nota:

El uso de LOG_LOCAL0 a través de LOG_LOCAL7 para el parámetro facility de openlog() no está disponible en Windows.

Ver también

  • openlog() - Open connection to system logger
  • closelog() - Cerrar conexión al log del sistema