openlog

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

openlog — Ouvre la connexion à l'historique système

Description

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

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

Retourne toujours true.

Historique

Version	Description
8.2.0	La fonction retourne maintenant toujours `true`. Auparavant, elle renvoyait `false` en cas d'échec.

Voir aussi

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

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

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]

down

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));
    }
}
?>

＋add a note