View source for 错误处理

<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Error_reporting -->
[[en:Error_reporting]]
[[fr:Gestion_d'erreur]]
[[es:Gestión_de_errores]]
<!-- END interlang links -->

[[Category:Core]]
[[Category:开发]]
{{TemplateDocDevZh}}

=函数=
在 Dolibarr 日志文件中记录日志信息的函数：

<syntaxhighlight lang="php">dol_syslog($message, LOG_DEBUG|LOG_INFO|LOG_WARNING|LOG_ERR);</syntaxhighlight>

日志级别与 Syslog 模块（见下文）中定义的设置相关。

在屏幕上显示错误消息的函数（必须在从不到达的代码中保留使用）：

<syntaxhighlight lang="php">dol_print_error($db,texte);</syntaxhighlight>

=Syslog调试日志模块= 
跟踪模块包含在Dolibarr的其他可管理模块中，允许您启用/更改要查看的错误级别。

要访问此模块的配置页面，请转到 '''主页->设置->模块/应用'''，然后单击syslog'''调试日志'''模块行行末尾的齿轮图标。

当然，必须启用此模块（'''Syslog'''）才能进行跟踪工作。

'''Syslog''' 的 '''facility''' 选项是用于记录消息的预定义配置概念。这是一个系统功能，用于告诉系统操作员错误来自何处（此处为dolibarr），并指示其优先级。您可以在PHP文档中找到''dol_syslog()''函数中使用的''openlog()''函数的更多信息：http://www.php.ne/openlog

通常，除非您知道自己在做什么，否则应将此值保留为 '''LOG_USER''' 。

下一个选项 '''file''' 允许您选择要保存日志的文件。指定的路径必须相对于根（/）目录。如果保持原样（默认选项DOL_DOCUMENT_ROOT/dolibarr.log），它将在 Dolibarr 的 documents 目录中创建。当然，要做到这一点，您的web服务器必须对该目录具有写入权限。

通常，'''file''' 设施将更频繁地工作，因为它不依赖于服务器的系统配置，也不依赖于可能需要的syslog守护进程（唯一可能发生的问题是web服务器没有对目录的写入权限）。

最后，日志级别表示您希望看到多少种类型的消息。LOG_DEBUG(7) 是最详细的选项，它会打印通过dol_syslog()函数传递的任何消息。LOG_EMERG(0) 正好相反，只跟踪严重错误的消息。

有关更多详情，请参阅 [[Module Syslog (developer)]] 页面。

=其他不常见的系统日志=
==Webserver logs==
===Apache===
请注意，除了syslog模块之外，您还可以在Apache日志中找到PHP/Apache技术错误（无论syslog模块的状态/配置如何）。但这仅发生在安装或环境的技术问题上。一个正常工作的 Dolibarr 应用程序永远不会显示这些文件中的任何内容。在标准的 Linux 系统上，这些痕迹可以在 '''/var/log/apache[2]/[dolibarr]-error.log''' 文件中看到。您可以使用以下命令从终端实时查看它们：
<syntaxhighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxhighlight>
===Nginx===
如果你使用nginx来做 Dolibarr 的服务器，一些有用的调试信息可以在这里找到：

<syntaxhighlight lang="bash">tail -f /var/log/nginx/error.log</syntaxhighlight>