Documentation PHP en français

  • Français

syslog

(PHP 4, PHP 5)

syslogGénère un message dans l'historique système

Description

bool syslog ( int $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_PERRORLOG_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