WordPress调试完整指南（启用WP_DEBUG + 其他工具）

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

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

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

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

• WordPress调试模式和调试日志介绍
• 如何启用WordPress调试模式（三种方法）
• 调试WordPress的其他一些方法

WP Debug有什么作用？

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

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

启用Debug模式后，只要出现问题（即使它不会立即引起问题），您就会看到如下消息：

WordPress网站上的WP_DEBUG错误示例

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

什么是WordPress调试日志？

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

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

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

wp-content/debug.log

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

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

通常，您需要WP_DEBUG_DISPLAY与WP_DEBUG_LOG.

如何启用WordPress Debug模式

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

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

如何使用WordPress调试插件

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

WP Debugging插件

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

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

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

要配置一些选项，您可以转到工具 → 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包括调试许多不同的领域有所帮助：

• 数据库查询。
• PHP错误。
• 钩子和动作。
• 古腾堡编辑器区块。
• 排队的脚本和样式表。
• HTTP API调用。
• 用户功能。

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

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

Query Monitor插件

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

New Relic

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

服务器日志

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

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

小结

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

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

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