Description
bool
syslog ( int priority, string message )
syslog() génère un message qui
sera inscrit dans l'historique par le système.
priority est une combinaison des valeurs
d'accès et de niveau, qui seront décrites dans la
prochaine section. Le dernier argument est le message
à envoyer. Attention : les caractères %m
seront remplacés par l'erreur (sous forme de chaîne),
présente dans errno.
Tableau 1. Priorités syslog()(en ordre décroissant)
| Constante | Description |
|---|
| LOG_EMERG | système inutilisable |
| LOG_ALERT | une décision doit être prise immédiatement |
| LOG_CRIT | condition critique |
| LOG_ERR | condition d'erreur |
| LOG_WARNING | condition d'alerte |
| LOG_NOTICE | condition normale, mais significative |
| LOG_INFO | message d'information |
| LOG_DEBUG | message de débogage |
Exemple 1. Utilisation de syslog()
<?php
define_syslog_variables();
// ouverture de syslog, ajout du PID et envoi simultané du
// message à la sortie standard et à un mécanisme
// spécifique
openlog("myScriptLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);
// quelques lignes de code
if (authorized_client()) {
// faire quelquechose
} else {
// client non autorisé!
// notation de la tentative
$access = date("Y/m/d H:i:s");
syslog(LOG_WARNING, "Client non autorisé: $access $_SERVER[REMOTE_ADDR] ($_SERVER[HTTP_USER_AGENT])");
}
closelog();
?>
|
|
Pour plus d'informations sur comment mettre en place un gestionnaire
d'historique, reportez-vous au manuel Unix, page 5
syslog.conf(5). D'autres informations
sur les systèmes d'historique et leurs options sont aussi
disponibles dans le manuel
syslog(3) des machines Unix.
Avec Windows NT, l'historique est pris en charge par Event Log.
Note :
L'utilisation de LOG_LOCAL0 Ã
LOG_LOCAL7 pour le paramètre
facility de la fonction openlog()
n'est pas disponible sous Windows.
Voir aussi
define_syslog_variables(),
openlog() et
closelog().
