(PHP 4, PHP 5, PHP 7, PHP 8)
syslog — Génère un message dans l'historique système
Description
syslog(int
$priority
, string
$message
): true
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.
Valeurs de retour
Retourne toujours true
.
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
Sur Windows, 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
- Paramètre INI syslog.filter (à partir de PHP 7.3)