syslog

(PHP 4, PHP 5, PHP 7, PHP 8)

syslogGenera un mensaje en el historial del sistema

Descripción

syslog(int $priority, string $message): true

syslog() genera un mensaje que será registrado en el historial por el sistema.

Para más información sobre cómo configurar un gestor de historial, consúltese el manual Unix, página 5 syslog.conf (5). Otra información sobre los sistemas de historial y sus opciones también está disponible en el manual syslog (3) de las máquinas Unix.

Parámetros

priority

Una de las LOG_EMERG, LOG_ALERT, LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG constantes.

message

El mensaje a enviar.

Valores devueltos

Siempre devuelve true.

Ejemplos

Ejemplo #1 Ejemplo con syslog()

<?php
// apertura de syslog, adición del PID y envío simultáneo del
// mensaje a la salida estándar y a un mecanismo
// específico
openlog("myScriptLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);

// algunas líneas de código

if (authorized_client()) {
// hacer algo
} else {
// cliente no autorizado!
// registro del 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, el historial es gestionado por el registro de eventos.

Nota:

El uso de LOG_LOCAL0 a LOG_LOCAL7 para el argumento facility de la función openlog() no está disponible en Windows.

Ver también

  • openlog() - Abre la conexión al historial del sistema
  • closelog() - Cierra la conexión al registro del sistema
  • Parámetro INI syslog.filter (a partir de PHP 7.3)