syslog
(PHP 4, PHP 5)
syslog — Generar un mensaje de registro de sistema
Descripción
syslog() genera un mensaje de registro que será distribuido por el registro del sistema.
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.
Lista de parámetros
- prioridad
-
prioridad es una combinación del valor facilidad y el nivel. Las valores posibles son:
Prioridades de syslog() (en orden descendiente) Constante Descripción LOG_EMERG el sistema es inutilizable LOG_ALERT debe tomarse una acción inmediatamente LOG_CRIT condiciones crÃticas LOG_ERR condiciones de error LOG_WARNING condiciones de advertencia LOG_NOTICE condición normal, pero significativa LOG_INFO mensaje informativo LOG_DEBUG mensaje de nivel de depuración - mensaje
-
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.
Valores retornados
Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.
Ejemplos
Example#1 Uso de syslog()
<?php
definir_variables_syslog();
// abrir syslog, incluir el ID de proceso y enviar
// el registro a la salida de error estándar, usar
// también un mecanismo de registro definido por el
// usuario
openlog("registroDeMiScript", LOG_PID | LOG_PERROR, LOG_LOCAL0);
// código 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();
?>
Notes
En Windows NT, el servicio syslog es emulado usando el Registro de Eventos.
Note: El uso de los valores LOG_LOCAL0 a LOG_LOCAL7 para el parámetro recurso de openlog() no está disponible en Windows.