Module Syslog (développeur)
Syslog | |
---|---|
Numéro/ID du module | 42 |
Doc utilisateur du module | Aucune |
Doc développeur du module | Cette page |
Fonction du module
Ce module permet d'activer la fonction de logging (journalisation) dans Dolibarr. Le logging permet d'enregistrer des messages de log :
- Dans un fichier
- Le fichier par défaut sera DOL_DATA_ROOT/dolibarr.log (par exemple C:/dolibarr/documents/dolibarr.log).
- Il est possible de changer le fichier d'enregistrement dans la page de configuration du module.
- Dans les logs systemes (avec la fonction syslog())
Voir la configuration du module pour choisir.
Fonction PHP
Définition
Pour utiliser le logging dans du code PHP, il faut utiliser la fonction suivante :
dol_syslog($message, $level = LOG_INFO)
Cette fonction est définie dans le fichier dolibarr/htdocs/lib/functions.lib.php
Paramètres
- $message : chaîne à enregistrer dans le fichier de log
- $level : constante permettant d'indiquer le niveau du message. Elle peut prendre les valeurs suivantes:
- Sur serveur Windows : LOG_ERR=4, LOG_WARNING=5, LOG_NOTICE=LOG_INFO=LOG_DEBUG=6
- Sur serveur Unix : LOG_ERR=3, LOG_WARNING=4, LOG_INFO=6, LOG_DEBUG=7
- Il est ensuite possible de configurer le niveau d'enregistrement des logs dans la page de configuration du module.
Remarques
"Les fonctions syslog sont bugguées sous Windows et genèrent des fautes de protection mémoire.
Pour resoudre, utiliser le loggage fichier, au lieu du loggage syslog (configuration du module).
Si SYSLOG_FILE_NO_ERROR est défini, on ne génère pas de message en cas d'erreur lors de l'écriture log."
Source: documentation Doxygen
Voir aussi
Documentation Doxygen : [1]