(PHP 4, PHP 5)
syslog — Genera un mensaje log de sistema
$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.
priority
priority es una combinación del tipo y el nivel.
Posibles valores:
| 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 |
messageEl 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.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
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();
?>
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
facilityde openlog() no está disponible en Windows.