WordPress调试完整指南(启用WP_DEBUG + 其他工具)

WordPress调试完整指南(启用WP_DEBUG + 其他工具)

在一个完美的世界中,您永远不会遇到需要调试的问题。但在现实世界中,您几乎肯定会在WordPress网站上遇到需要深入了解的问题。

为了帮助您做到这一点,WordPress包含其自己的内置调试模式,您还可以找到有用的第三方工具来帮助您调试WordPress。

在这篇文章中,我们将深入研究内置的WordPress调试模式并向您展示如何启用它。然后,我们还将分享其他一些调试WordPress网站的方法。

这是我们将涵盖的所有内容:

WP Debug有什么作用?

核心WordPress软件是用PHP编写的,插件和主题也是如此。

如果您的网站出现问题,WordPress Debug模式可以通过显示所有PHP错误、通知和警告来帮助您找出问题所在。

启用Debug模式后,只要出现问题(即使它不会立即引起问题),您就会看到如下消息:

WordPress网站上的WP_DEBUG错误示例

WordPress网站上的WP_DEBUG错误示例

然后,您可以修复问题或将其报告给您的开发人员或主题/插件的开发人员。

什么是WordPress调试日志?

当你本身启用WordPress的调试模式,你会看到的消息像上面网站上的例子在那一刻-但这些消息不会被保存任何地方。

如果您想保存它们,您还可以启用WordPress调试日志以将所有这些消息和错误保存到您服务器上的文件中。

通过将WP_DEBUG_LOG常量设置为true启用后,WordPress会将所有问题写入以下文件:

wp-content/debug.log

但是,您也可以指定自定义文件路径以将日志写入服务器上的其他位置。

如果您想将问题保存到日志中但不想在页面的HTML中公开显示它们(如上面的示例屏幕截图),您还可以使用WP_DEBUG_DISPLAY常量来保持启用调试模式但不在您的站点上显示消息。

通常,您需要WP_DEBUG_DISPLAYWP_DEBUG_LOG.

如何启用WordPress Debug模式

要启用WordPress调试模式,您有多种选择。我们将介绍三种启用它的方法:

  1. 如何使用WordPress调试插件
  2. 如何手动启用WordPress调试模式

如何使用WordPress调试插件

您可以使用免费的WordPress调试插件,启用调试模式。WordPress.org上有几个选项,但我们推荐Andy Fragen提供的免费WP Debugging插件

WP Debugging插件

WP Debugging插件

安装并激活插件后,它会立即开始工作。默认情况下,它将以下常量设置为true(即启用以下功能):

  • WP_DEBUG – 启用调试模式。
  • WP_DEBUG_LOG – 将消息保存到日志文件。
  • SCRIPT_DEBUG
  • SAVEQUERIES

我们将在本文稍后介绍最后两个常量的作用。

要配置一些选项,您可以转到工具 → WP Debugging:

WP Debugging插件设置

WP Debugging插件设置

完成后,请确保禁用插件以禁用调试模式。

如何手动启用WordPress调试模式

最后,您还可以通过手动将常量添加到wp-config.php文件来启用WordPress调试模式。

首先,通过FTP连接到您的服务器并编辑wp-config.php文件。默认情况下,此文件位于您站点的根文件夹中(除非您出于安全原因移动了它)。

要启用只是基本的WordPress的调试模式,添加下面的代码片段上面写着/* That’s all, stop editing! Happy blogging. */:

// Enable WP_DEBUG modedefine( 'WP_DEBUG', true );

您还可以根据自己的喜好使用以下一些常量:

// Enable Debug logging to the /wp-content/debug.log filedefine( 'WP_DEBUG_LOG', true );// Disable display of errors and warningsdefine( 'WP_DEBUG_DISPLAY', false );@ini_set( 'display_errors', 0 );

完成后,您可以将常量设置为false或仅删除代码段以禁用调试模式。

确保在完成后禁用WordPress中的调试模式

调试模式在您尝试解决WordPress问题时很有用,但您不应该让它24/7全天候启用,因为它可以将您的PHP代码中的文本显示给网站访问者。

我们在上面提到了这一点 – 但这只是提醒您在完成故障排除后始终禁用调试模式。

其他调试WordPress的方法

除了我们上面介绍的内置调试工具之外,还有其他几个内置和第三方工具可以帮助您调试WordPress网站。

脚本调试

SCRIPT_DEBUG是另一个内置常量,它强制WordPress使用核心CSS和JavaScript文件的开发版本,而不是它通常加载的缩小版本。

如果您正在测试对内置 .js 或.css文件的更改,这会很有帮助。

要启用SCRIPT_DEBUG,您可以:

  • 使用上面的免费WP Debugging插件,默认情况下启用它。
  • 将以下常量添加到您的wp-config.php文件中 –define( 'SCRIPT_DEBUG', true );

数据库查询调试

如果您的站点的数据库有问题,您可以使用SAVEQUERIES常量来启用数据库查询日志记录:

  • 每个数据库查询。
  • 调用数据库查询的函数。
  • 查询用了多长时间。

要启用查询日志记录,您可以:

  • 使用上面的免费WP Debugging插件,默认情况下启用它。
  • 将以下常量添加到您的wp-config.php文件中 –define( 'SAVEQUERIES', true );

注意:这会影响您网站的性能,因此请尽可能在临时网站上使用它,并在完成后立即将其禁用。

Query Monitor插件

Query Monitor插件是一个免费的插件,这对在WordPress包括调试许多不同的领域有所帮助:

总的来说,它是您能找到的最好的WordPress调试工具之一,这就是为什么它在320多条评论中几乎获得了完美的5星评级。

安装并激活插件后,您将在WordPress工具栏上获得一些显示调试信息的新选项。单击后,这些选项将打开一个新的Query Monitor框,为您提供更多信息:

Query Monitor插件

Query Monitor插件

为了更详细地了解,我们有一整篇关于如何使用Query Monitor插件的文章

New Relic

New Relic是用于分析和调试站点性能的高级工具。它可以帮助您发现影响站点性能的瓶颈和问题。

服务器日志

最后,您的服务器日志也可以成为调试WordPress的有用工具。

如果您在使用宝塔面板,也可以轻松查询服务器日志,参考宝塔面板日志查阅教程

小结

如果您需要调试WordPress,内置的WordPress调试模式提供了一种查看PHP错误和通知的有用方法。

您可以使用插件或通过将代码片段添加到您网站的wp-config.php文件来启用它。

如需更多帮助,您还可以使用其他内置工具或第三方工具,例如New Relic和免费的Query Monitor插件。

评论留言