openlog

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

openlogOuvre la connexion à l'historique système

Description

openlog(string $prefix, int $flags, int $facility): bool

openlog() ouvre la connexion à l'historique système.

L'utilisation de openlog() est optionnelle. Cette fonction sera automatiquement appelée par la fonction syslog() si nécessaire, auquel cas prefix vaudra par défaut false.

Liste de paramètres

prefix

La chaîne prefix sera ajoutée à chaque message.

flags

L'argument flags indique les options de journalisation utilisées pour générer le message.

Options pour la fonction openlog()
Constante Description
LOG_CONS Si une erreur survient lors de l'envoi des données au gestionnaire d'historique, écrire directement l'erreur sur la console.
LOG_NDELAY Ouvre immédiatement une connexion au gestionnaire d'historique.
LOG_ODELAY Retarde l'ouverture de la connexion jusqu'à ce que le premier message soit enregistré (par défaut).
LOG_PERROR Envoie le message au gestionnaire standard.
LOG_PID Inclut le PID à chaque message.
Vous pouvez utiliser une ou plusieurs de ces options. Pour les combiner, utiliser l'opérateur OR. Par exemple, pour ouvrir immédiatement la connexion, écrire sur la console et inclure le PID de chaque message, utilisez : LOG_CONS | LOG_NDELAY | LOG_PID.

facility

L'argument facility sert à indiquer quel programme enregistre ce message. Cela vous permet de spécifier (sur la machine d'historique) comment traiter les messages venant de plusieurs serveurs.

Paramètre facility d'openlog()
Constante Description
LOG_AUTH sécurité/messages d'autorisation (utilisez LOG_AUTHPRIV, pour remplacer cette constante sur les systèmes où elle est définie).
LOG_AUTHPRIV sécurité/messages d'autorisation (privé)
LOG_CRON démon horloge (cron et at)
LOG_DAEMON autres démons système
LOG_KERN noyau (kernel)
LOG_LOCAL0 ... LOG_LOCAL7 réservé pour utilisation locale. Inutilisable sous Windows
LOG_LPR imprimante (line printer subsystem)
LOG_MAIL messagerie mail
LOG_NEWS USENET : groupes de news (newsgroup)
LOG_SYSLOG messages générés en interne par syslogd
LOG_USER messages utilisateurs génériques
LOG_UUCP sous-système UUCP

Note:

LOG_USER est le seul type valide sous les environnements Windows.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Voir aussi

  • syslog() - Génère un message dans l'historique système
  • closelog() - Ferme la connexion à l'historique système

add a note add a note

User Contributed Notes 2 notes

up
2
sam dot wankaner at gmail dot com
9 years ago
In second parameter int $option, PI means Process ID (PID).
That is the unique number given to that process. For eg [30326]
up
0
Nimja
11 years ago
To those curious; switching between different facilities is NOT an issue. There is no apparent memory overhead (nor slowdown) by calling openlog multiple(12 * 10000) times.

Shown by this example:

<?php
$facilities
= array(
   
LOG_AUTH,
   
LOG_AUTHPRIV,
   
LOG_CRON,
   
LOG_DAEMON,
   
LOG_KERN,
   
LOG_LOCAL0,
   
LOG_LPR,
   
LOG_MAIL,
   
LOG_NEWS,
   
LOG_SYSLOG,
   
LOG_USER,
   
LOG_UUCP,
);

for (
$i = 0; $i < 10000; $i++) {
    foreach (
$facilities as $facility) {
       
openlog('test', LOG_PID, $facility);
       
syslog(LOG_ERR, "This is a test: " . memory_get_usage(true));
    }
}
?>
To Top