Configuration de la journalisation
Cette section décrit le tableau de configuration de la journalisation
de l'application.
Structure...
[booléen],
'level' => '[niveau]',
'handlers' => array(
'[handler 1]',
array (
'handler' => [handler 2],
'level' => '[niveau]',
// Autres paramètres propre à cet handler
[...]
),
[...]
),
);]]>
...
Paramètres de configuration
enable
Booléen permatant d'activer ou désactiver complètement la
journalisation. Par défaut : False
level
Ce paramètre défini le niveau minimum de la journalisation :
tous les messages des niveaux inférieurs ne seront pas inclus dans le
journal de l'application. Les niveaux de journalisation gérés par
l'application sont (dans l'ordre du plus petit au plus grand) :
DEBUG
INFO
WARNING
ERROR
FATAL
handlers
Tableau permettant de configurer les handlers de la
journalisation. Chaque handler gère les messages
journalisés d'une manière qui lui est propre.
Plusieurs handlers peuvent être configurés en même
temps (y compris plusieurs handlers du même type).
Ce tableau peut contenir simplement le nom du type de handler
à utiliser ou bien des tableaux configurant un à un chacun des
handlers. Dans ce second cas, la structure de la
configuration d'un handler est la suivante :
Structure...
[type],
'level' => '[niveau]',
// Autres paramètres propre à ce handler
[...]
)]]>
...
Paramètres de configuration d'un handler
handler
Type du handler (voir ci-dessous).
level
Ce paramètre défini le niveau minimum de la journalisation
spécifique à cet handler. Si ce paramètre est omis,
le niveau global sera utilisé. Les valeurs possibles de ce paramètre
sont les mêmes que pour le paramètre $GLOBALS['LSlog']['level']
.
Il existe plusieurs types d'handlers gérés par
l'application :
file
Journalisation dans un simple fichier texte. Le chemin du
fichier peut être configuré via le paramètre path.
Si ce paramètre est omis, le chemin du fichier par défaut est soit la
valeur de la variable $GLOBALS['LSlog']['filename']
(pour la rétro-compatibilité avec les anciennes versions d'LdapSaisie)
ou à défaut : tmp/LS.log.
syslog
Journalisation via le service syslog.
Il est possible de configurer une priorité systématique pour les
messages journalisés. À défaut, la priorité sera déterminée
automatiquement en fonction du niveau du message. Les valeurs
possibles de ce paramètre sont : EMERG, ALERT, CRITICAL,
ERROR, WARNING, NOTICE, INFO, DEBUG
system
Journalisation via le gestionnaire d'erreurs PHP. Cet
handler utilise la fonction PHP error_log.
Pour plus d'informations sur comment configurer le gestionnaire d'erreurs
PHP, consulter la documentation
officielle.
email
Journalisation via l'envoi d'un email : chaque message journalisé
déclenchera l'envoi d'un email au destinataire configuré. L'adresse email
du destinataire peut-être configurée via le paramètre recipient
.
Il est conseillé d'utiliser ce type d'handler
avec un niveau minimum de journalisation important (FATAL
recommandé) pour ne pas déclencher un nombre trop important d'envois d'emails.