(PHP 4, PHP 5)
syslog — Generar un mensaje de registro de sistema
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.
prioridad es una combinación del valor facilidad y el nivel. Las valores posibles son:
| 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 |
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.
Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.
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();
?>
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.