如何启用 WordPress 调试模式来修复错误

如何在 WordPress 中启用调试模式或获取有关网络浏览器上显示的 WordPress 错误的更多信息？如果您是 WordPress 用户或开发人员并提出这些问题，那么您就找到了正确的资源。本指南将向您展示如何启用 WordPress 的调试功能。

WordPress 为开发人员和非程序员或普通用户提供了多种强大的调试工具，您可以使用可用的配置选项来启用这些工具。启用这些选项后，可以通过显示详细的错误信息来帮助您快速查找并解决错误。

我们将使用我们在设置虚拟站点进行测试时遇到的以下错误进行演示。

当您查看此错误时，您会发现它没有太多信息。造成这种情况的原因可能有很多：数据库服务器可能已关闭，或者 wp-config.php 配置文件中定义的数据库连接设置（即数据库名称、数据库用户和用户密码）可能是错的。

那么我们如何才能获得有关上述错误的更多信息呢？ WP_DEBUG 选项是一个 PHP 永久全局变量，它在整个 WordPress 中激活“debug”模式，从而导致所有 PHP 错误、通知和警告显示在浏览器上。

这个“debug”功能是在 WordPress 2.3.1 版本中添加的，并在 wp-config.php 中配置 - 最重要的文件之一在您的 WordPress 安装中。

默认情况下，在任何 WordPress 安装中，“debug”功能都设置为 false。要启用WP_DEBUG，请将其设置为true。

首先，进入您的网站安装目录，例如 /var/www/html/mysite.com，然后使用您喜欢的文本编辑器打开 wp-config.php 文件。

cd /var/www/html/mysite.com
sudo vim wp-config.php

寻找这条线。

define( 'WP_DEBUG',  false );

并将其更改为

define( 'WP_DEBUG', true );

保存文件并关闭它。

现在调试模式已被触发。如果我们重新加载显示错误的页面，我们可以看到详细的错误信息，如下面的屏幕截图所示。

还有其他扩展WP_DEBUG的调试选项，对于创建插件或主题或任何其他组件的 WordPress 开发人员特别有用。它们是WP_DEBUG_LOG和WP_DEBUG_DISPLAY。

WP_DEBUG_LOG 选项设置为 true 时，会将所有错误保存到 /wp-content 内的 debug.log 日志文件中/ 默认目录。这对于以后的分析或处理很有用。

define( 'WP_DEBUG_LOG', true );

但您可以指定自定义日志文件，例如 /var/log/nginx/mysite.com_wp-errors.log：

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

WP_DEBUG_DISPLAY 控制调试消息是否显示在页面的 HTML 中。默认情况下，它设置为true。要禁用它，请将其设置为false。

define( 'WP_DEBUG_DISPLAY', false );

如果您使用共享主机，您可能无法访问服务器后端来编辑 WordPress 文件（在本例中为 wp-config.php 文件）。

或者，如果您只是想从管理仪表板更改设置，您可以安装并使用名为“调试栏”的插件，该插件使您只需单击一下即可从管理仪表板轻松启用/禁用WP_DEBUG工具栏。

这个插件的杀手级功能是它的故障保护和聪明，如果出现错误，它会自动退出 WP_DEBUG 模式。

参考：WordPress 中的调试。