错误处理 - Revision history

ShengGang: /* Nginx */

2023-09-27T02:30:06Z

Nginx

← Older revision		Revision as of 02:30, 27 September 2023
Line 48:		Line 48:
	<syntaxhighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxhighlight>		<syntaxhighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxhighlight>
	===Nginx===		===Nginx===
	~~If you are using nginx to serve~~ Dolibarr ~~some useful debugging information is often to be found there.~~		如果你使用nginx来做 Dolibarr 的服务器，一些有用的调试信息可以在这里找到：

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

ShengGang at 02:28, 27 September 2023

2023-09-27T02:28:17Z

← Older revision		Revision as of 02:28, 27 September 2023
Line 43:		Line 43:

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

	~~=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:
	<syntaxhighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxhighlight>		<syntaxhighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxhighlight>
	==Nginx==		===Nginx===
	If you are using nginx to serve Dolibarr some useful debugging information is often to be found there.		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>		<syntaxhighlight lang="bash">tail -f /var/log/nginx/error.log</syntaxhighlight>

ShengGang: /* 其他罕见的系统日志 */

2023-09-27T02:24:34Z

其他罕见的系统日志

← Older revision		Revision as of 02:24, 27 September 2023
Line 42:		Line 42:
	有关更多详情，请参阅 [[Module Syslog (developer)]] 页面。		有关更多详情，请参阅 [[Module Syslog (developer)]] 页面。

	=~~其他罕见的系统日志~~=		=其他不常见的系统日志=
	是		请注意，除了syslog模块之外，您还可以在Apache日志中找到PHP/Apache技术错误（无论syslog模块的状态/配置如何）。但这仅发生在安装或环境的技术问题上。一个正常工作的 Dolibarr 应用程序永远不会显示这些文件中的任何内容。在标准的 Linux 系统上，这些痕迹可以在 '''/var/log/apache[2]/[dolibarr]-error.log''' 文件中看到。您可以使用以下命令从终端实时查看它们：

	=Webserver logs=		=Webserver logs=

ShengGang at 02:19, 27 September 2023

2023-09-27T02:19:18Z

← Older revision		Revision as of 02:19, 27 September 2023
Line 41:		Line 41:

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

			=其他罕见的系统日志=
			是

	=Webserver logs=		=Webserver logs=

ShengGang: /* Module Syslog */

2023-09-27T02:16:46Z

Module Syslog

← Older revision		Revision as of 02:16, 27 September 2023
Line 7:		Line 7:
	[[es:Gestión_de_errores]]		[[es:Gestión_de_errores]]
	<!-- END interlang links -->		<!-- END interlang links -->


	[[Category:Core]]		[[Category:Core]]
Line 24:		Line 23:
	<syntaxhighlight lang="PHP">dol_print_error($db,texte);</syntaxhighlight>		<syntaxhighlight lang="PHP">dol_print_error($db,texte);</syntaxhighlight>

	=~~Module Syslog~~=		=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.~~		跟踪模块包含在Dolibarr的其他可管理模块中，允许您启用/更改要查看的错误级别。

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

	~~To get to the error reporting module configuration page, go to Home, Configuration, Modules and use the configuration icon of the last module on the screen:~~ ''Syslog''.		当然，必须启用此模块（'''Syslog'''）才能进行跟踪工作。

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

	The '''facility''' option allows you to use pre-set facilities to log your errors. Facilities are a system-level feature to tell your syslog operator where this error comes from, to judge priority and all that. You can find more about this inside the PHP documentation for the ''openlog()'' function which is used inside the ''dol_syslog()'' function: http://www.php.ne/openlog		通常，除非您知道自己在做什么，否则应将此值保留为 '''LOG_USER''' 。
	~~Really, you should leave it to~~ '''LOG_USER''' ~~unless you know exactly what you're doing.~~

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

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

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

	~~More information on page~~ [[Module Syslog (developer)]].		有关更多详情，请参阅 [[Module Syslog (developer)]] 页面。

	=Webserver logs=		=Webserver logs=

PolyglotBot: Adding interlang links (links to translated versions of this page in other languages) triggered by origin English page "Error_reporting" update.

2023-09-27T01:38:29Z

Adding interlang links (links to translated versions of this page in other languages) triggered by origin English page "Error_reporting" update.

← Older revision		Revision as of 01:38, 27 September 2023
Line 1:		Line 1:
			<!-- 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:Core]]

ShengGang: /* Functions */

2023-09-27T01:37:34Z

Functions

← Older revision		Revision as of 01:37, 27 September 2023
Line 4:		Line 4:
	{{TemplateDocDevZh}}		{{TemplateDocDevZh}}

	= ~~Functions~~ =		=函数=
	~~Following function allows to log informations in~~ Dolibarr ~~log file~~		在 Dolibarr 日志文件中记录日志信息的函数：
	~~<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).~~

	~~Following function can be used to add error information on screen. Usage must be reserved in never reached code.~~		<syntaxhighlight lang="PHP">dol_syslog($message, LOG_DEBUG\|LOG_INFO\|LOG_WARNING\|LOG_ERR);</syntaxhighlight>
	<~~syntaxHighlight~~ lang="~~php~~">~~dol_print_error~~($db,~~texte~~);</~~syntaxHighlight~~>

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

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

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

			=Module 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 30:		Line 33:
	More information on page [[Module Syslog (developer)]].		More information on page [[Module Syslog (developer)]].

	= Webserver logs =		=Webserver logs=
	== Apache ==		==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~~>		<syntaxhighlight lang="bash">tail -f /var/log/apache2/dolibarr-error.log</syntaxhighlight>
	== Nginx ==		==Nginx==
	If you are using nginx to serve Dolibarr some useful debugging information is often to be found there.		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~~>		<syntaxhighlight lang="bash">tail -f /var/log/nginx/error.log</syntaxhighlight>

ShengGang: initialization

2023-09-27T01:27:33Z

initialization

New page

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

= Functions =
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).

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 =
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.

To get to the error reporting module configuration page, go to Home, Configuration, Modules and use the configuration icon of the last module on the screen: ''Syslog''.

Of course, this module ('''Syslog''') must be activated for the following to work.

The '''facility''' option allows you to use pre-set facilities to log your errors. Facilities are a system-level feature to tell your syslog operator where this error comes from, to judge priority and all that. You can find more about this inside the PHP documentation for the ''openlog()'' function which is used inside the ''dol_syslog()'' function: http://www.php.ne/openlog
Really, you should leave it to '''LOG_USER''' unless you know exactly what you're doing.

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 writeable).

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.

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:
<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>