(PHP 4, PHP 5)
syslog — Génère un message dans l'historique système
$priority
, string $message
)syslog() génère un message qui sera inscrit dans l'historique par le système.
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.
priority
priority est une combinaison des valeurs
d'accès et de niveau. Les valeurs possibles sont :
| 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éboguage |
message
Le message à envoyer. Attention : les caractères %m seront remplacés par l'erreur (sous forme de chaîne), présente dans errno.
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Exemple #1 Exemple avec syslog()
<?php
// 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, "Unauthorized client: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");
}
closelog();
?>
Avec Windows NT, l'historique est pris en charge par le log d'événements.
Note:
L'utilisation de LOG_LOCAL0 à LOG_LOCAL7 pour le paramètre
facilityde la fonction openlog() n'est pas disponible sous Windows.