syslog
(PHP 4, PHP 5)
syslog — Génère un message dans l'historique système
Description
$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.
Liste de paramètres
-
priority
-
priority
est une combinaison des valeurs d'accès et de niveau. Les valeurs possibles sont :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é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.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Exemples
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(); ?>
Notes
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
facility
de la fonction openlog() n'est pas disponible sous Windows.
Voir aussi
- openlog() - Ouvre la connexion à l'historique système
- closelog() - Ferme la connexion à l'historique système