31,034
edits
No edit summary |
m (→Module Syslog) Tag: 2017 source edit |
||
| (5 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
<!-- BEGIN origin interlang links --> | |||
<!-- You can edit this section but do NOT remove these comments | |||
Links below will be automatically replicated on translated pages by PolyglotBot --> | |||
[[fr:Gestion_d'erreur]] | |||
[[es:Gestión_de_errores]] | |||
[[zh:错误处理]] | |||
<!-- END interlang links --> | |||
[[Category:Core]] | [[Category:Core]] | ||
{{TemplateDocDevEn}} | {{TemplateDocDevEn}} | ||
| Line 4: | Line 12: | ||
= Functions = | = Functions = | ||
Following function allows to log informations in Dolibarr log file | Following function allows to log informations in Dolibarr log file | ||
< | <syntaxHighlight lang="php">dol_syslog($message, LOG_DEBUG|LOG_INFO|LOG_WARNING|LOG_ERR);</syntaxHighlight> | ||
The log level is related to setup defined in module Syslog (see lower). | The log level is related to setup defined in module Syslog (see lower). | ||
Following function can be used to add error information on screen. Usage must be reserved in never reached code. | Following function can be used to add error information on screen. Usage must be reserved in never reached code. | ||
< | <syntaxHighlight lang="php">dol_print_error($db,texte);</syntaxHighlight> | ||
= Module Syslog = | = Module Log Debug (also called Syslog) = | ||
The error reporting module is integrated with other Dolibarr modules. It allows you to configure what level of errors you would like to be reported and where. | The error reporting module is integrated with other Dolibarr modules. It allows you to configure what level of errors you would like to be reported and where. | ||
| Line 22: | Line 30: | ||
The next option, '''file''', allows you to choose a file in which you will store the logs. The path you will indicate there should be relative to the system root (/). If you live it as it is (default option DOL_DOCUMENT_ROOT/dolibarr.log), it will likely be opened in document directory. Of course, to do that, your web server must have write permissions on the directory you are using. | The next option, '''file''', allows you to choose a file in which you will store the logs. The path you will indicate there should be relative to the system root (/). If you live it as it is (default option DOL_DOCUMENT_ROOT/dolibarr.log), it will likely be opened in document directory. Of course, to do that, your web server must have write permissions on the directory you are using. | ||
Generally, the '''file''' facility will work more easily because it doesn't depend on your server configuration (or only for the directory that needs to be | Generally, the '''file''' facility will work more easily because it doesn't depend on your server configuration (or only for the directory that needs to be writable). | ||
Finally, the level of reporting is how many types of errors you want to report. LOG_DEBUG(7) is the strongest option, reporting pretty much everything that calls a dol_syslog() function. LOG_EMERG(0) is the opposite, letting you see only the errors that would really block your system. | Finally, the level of reporting is how many types of errors you want to report. LOG_DEBUG(7) is the strongest option, reporting pretty much everything that calls a dol_syslog() function. LOG_EMERG(0) is the opposite, letting you see only the errors that would really block your system. | ||
| Line 28: | Line 36: | ||
More information on page [[Module Syslog (developer)]]. | More information on page [[Module Syslog (developer)]]. | ||
= | = Webserver logs = | ||
== Apache == | |||
Note that you can have also find some technical PHP/Apache errors in apache log file (whatever is status/setup of this module). But this occurs only if there is a technical problem in your installation: On a typical Linux install, such logs will be available somewhere in '''/var/log/apache[2]/[dolibarr]-error.log'''. You can watch it ''live'' from the terminal by using: | Note that you can have also find some technical PHP/Apache errors in apache log file (whatever is status/setup of this module). But this occurs only if there is a technical problem in your installation: On a typical Linux install, such logs will be available somewhere in '''/var/log/apache[2]/[dolibarr]-error.log'''. You can watch it ''live'' from the terminal by using: | ||
< | <syntaxHighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxHighlight> | ||
== Nginx == | |||
If you are using nginx to serve Dolibarr some useful debugging information is often to be found there. | |||
<syntaxHighlight lang="bash">tail -f /var/log/nginx/error.log</syntaxHighlight> | |||