29,364
edits
Changes
m
no edit summary
Line 12:
Line 12:
Ce module permet d'activer la fonction de logging (journalisation) dans Dolibarr. Le logging permet d'enregistrer des messages de log :+Voir la configuration du module pour choisir.+Pour utiliser le logging dans du code PHP, il faut utiliser la fonction suivante :+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."''+
= Fonction du module =
= Fonction du module =
−This module allows to enable technical logging into Dolibarr. Logging is used to save messages into log files :
−* Dans un fichier
+* Into a file
−** Le fichier par défaut sera '''DOL_DATA_ROOT/dolibarr.log''' (par exemple '''C:/dolibarr/documents/dolibarr.log''').
+** File will be by default '''DOL_DATA_ROOT/dolibarr.log''' (for example '''C:/dolibarr/documents/dolibarr.log''').
−** Il est possible de changer le fichier d'enregistrement dans la page de configuration du module.
+** You can change file name on the setup page of module.
−* Dans les logs systemes (avec la fonction syslog())
+* Into systems logs (using syslog)
−See module setup to choose.
−= Fonction PHP =
+= PHP functions =
−== Définition ==
+== Definition ==
−To use loggin in your PHP coding, you must use the following function :
<source lang="php">
<source lang="php">
Line 31:
Line 31:
</source>
</source>
−''Cette fonction est définie dans le fichier dolibarr/htdocs/lib/functions.lib.php''
+''This function is defined into file dolibarr/htdocs/lib/functions.lib.php''
−== Paramètres ==
+== Parameters ==
−* '''$message''' : chaîne à enregistrer dans le fichier de log
+* '''$message''' : string with message to write into log file
−* '''$level''' : constante permettant d'indiquer le niveau du message. Elle peut prendre les valeurs suivantes:
+* '''$level''' : constant that define level of message. It can have following values:
−** Sur serveur Windows : LOG_ERR=4, LOG_WARNING=5, LOG_NOTICE=LOG_INFO=LOG_DEBUG=6
+** On Windows server: 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
+** On Unix/Linux server : 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.
+** You can then set the level of messages you want to write, with the module setup page.
−= Remarques =
+= Notes =
−''"Les fonctions syslog sont bugguées sous Windows et genèrent des fautes de protection mémoire.''
+''"Syslog functions are bugged with Windows et generates memory protection fault.''
−''Pour resoudre, utiliser le loggage fichier, au lieu du loggage syslog (configuration du module).
+''To solve this, use the file logging instead of syslog logging (see module setup page).
−If SYSLOG_FILE_NO_ERROR is defined in your PHP code, no message will be output on screen when there is an error when writing the log message."''
Source: documentation Doxygen
Source: documentation Doxygen
−= Voir aussi =
+= See also =
−Documentation Doxygen : [http://www.dolibarr.fr/doxygen/d9/d69/functions_8lib_8php.html#a9862cc723ca3a2d05ef5723946cc9250]
+Doxygen Documentation : [http://www.dolibarr.fr/doxygen/d9/d69/functions_8lib_8php.html#a9862cc723ca3a2d05ef5723946cc9250]
{{ToComplete}}
{{ToComplete}}