Red
PHP Manual

syslog

(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.

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_PERRORLOG_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.

Ver también


Red
PHP Manual