如何使用 WordPress 调试模式修复站点错误

技术教程 2021年11月11日

1335 0 7

尽管 WordPress 作为一个平台非常稳定，但您还是会在某些时候遇到错误.更重要的是，您可能不知道它是如何到达那里的或您可以做些什么来修复它.在这种情况下，WordPress 调试模式是救命稻草.

调试是一种找出"错误"为什么会造成严重破坏的方法，尽管您还必须弄清楚如何修复它.一些调试消息会给你一个指针.不过，一旦调试模式为您提供帮助，修复过程通常很简单.

在这篇文章中，我们将向您展示您需要了解的有关 WordPress 调试模式的所有信息.首先，让我们更深入地了解该模式的作用.

什么是 WordPress 调试模式

在很多情况下，您已经看到一个版本的调试正在运行.当您在 WordPress 网站上遇到错误时，这是正在运行的调试过程的一小部分-终点.在正常情况下，您会在您的站点上看到重大严重错误的通知.考虑诸如建立数据库连接时出错或 500 内部服务器错误.

不过，还有更多"无声"错误.换句话说，除非你去寻找，否则你不会知道发生了错误.WordPress 调试模式非常适合这些情况.

它会在您网站的后端或前端显示通知，并且不仅限于错误.启用调试模式(也称为 WP_DEBUG)也将显示有关底层代码的警告和通知.例如，您经常会看到网站方面未出现或未损坏的错误.这是设计使然.

因此，您可以使用 WP_DEBUG 来发现您网站的 PHP 代码问题，这些问题在修复后将为您提供更具抵抗力和性能的基础.

为什么要使用 WordPress 调试模式

公平地说，从表面上看，使用 WP_DEBUG 对普通网站用户并没有太多好处.这可以是这种情况，尽管它不是普遍的.事实上，对于大多数网站，您不需要使用调试模式，因为 WordPress 在这两个方面都很棒处理和显示错误.

不过，我们可以想到一些 WordPress 调试模式很方便的情况:

即使对于典型的网站所有者，激活 WP_DEBUG 也可以帮助您诊断在正常情况下不会出现的复杂问题.一个例子是 WordPress 白屏死机 (WSoD).很多时候，如果您使用 WordPress 调试模式，您会发现错误，这将使您在寻找修复程序时占得先机.
如果您是开发人员，WP_DEBUG 将是您工作流程中的宝贵工具.这是因为您想了解站点破坏错误，以及那些可能导致后续问题的琐碎问题.WordPress 调试模式显示了所有这些，以及更多.例如，您还会在代码中看到有关折旧函数和参数的通知.这些不会立即破坏您的网站，但一旦这些功能在以后消失，就会出现问题.

一般来说，WP_DEBUG 不应在实时站点上处于活动状态.因此，在使用本地或登台环境时，它更像是一种开发工具.即便如此，调试模式确实适用于实时站点，但频率很小且有规律.

如果您在实时站点上使用调试模式，则需要遵循一些规则:不要长时间使用它，在站点流量最少的时候激活它，并停用 WP_DEBUG完成后.这将最大限度地降低所涉及的风险，并使您的网站维护远离最终用户的视线.

如何以两种方式为您的网站启用 WordPress 调试模式

如果您想启用 WordPress 调试模式，有两种典型的方法:

打开您的 wp-config.php 文件并添加几行代码.
安装并激活插件以启用调试模式.

还有一些相关和配套模式可以帮助您调试网站.我们将在后面的部分介绍这些，但现在，让我们介绍手动方法.

1.通过wp-config.php文件

启用调试模式

如果您熟悉 WordPress 的核心文件，您就会了解 wp-config.php.对于初学者，此文件存储您的站点和服务器配置设置.这是一个可能导致建立数据库连接错误等问题的文件.

因此，您应该谨慎对待该文件.因此，在开始之前，您需要确保已准备好以下各项:

了解安全文件传输协议 (SFTP) 及其使用技巧.
合适的 SFTP客户端，例如FileZilla, Cyberduck 或传输.
您的 SFTP 凭据，您可以在托管仪表板中找到，或在您的
您网站的干净和当前的备份，以防您不得不滚动返回更改.
您可能需要专门的测试xt 编辑器，但不是必须的.

完成这些设置后，请通过 SFTP 登录您的站点.如果您只运行一个站点，根目录(也称为 www 或 public_html)将是您要去的地方.

不过，如果您在服务器上运行多个站点，它也可能位于具有您站点名称的目录中.找到正确的位置后，查找 wp-config.php 文件.请注意，还有一个 wp-config-sample.php 文件，但这不是您需要的.

找到文件后，右键单击并选择要编辑的选项.这会因您的 SFTP 解决方案而异，但通常很难错过:

打开文件后，您想添加一行以启用调试模式:

define( 'WP_DEBUG', true);

在读取 /* That's all, stop editing! Happy blogging.*/ 的行上方键入此内容.保存更改后，WordPress 调试模式处于活动状态.您还可以向文件中添加更多行.例如，您可以使用以下内容创建专用的书面 debug.log 文件:

define( 'WP_DEBUG_LOG', true );

不过，请记住使用 false 值而不是 true 来禁用 WP_DEBUG.作为替代方法，您可以从 wp-config.php 文件中删除相关行并重新保存更改.

2.使用专用插件启用 WordPress 的调试模式

您也可以使用插件来启用调试模式.如果您不喜欢在核心文件中闲逛，这将使该过程更易于访问.对此的最佳解决方案是 WP调试:

一旦你安装并激活插件，它就已经在工作了.它在您的 wp-config.php 中启用以下"常量":

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

您已经使用了前两个常量.SCRIPT_DEBUG 切换 WordPress 以使用核心 CSS 和 JavaScript 文件的开发版本.在正常情况下，WordPress 会使用缩小的文件，这在极少数情况下可能会导致问题.如果您正在寻找错误，这不会影响您，但如果您是开发人员，则可能会影响您.

SAVEQUERIES 也是一个以开发人员为中心的常量，它将数据库查询存储在一个全局数组 ($wpdb->queries) 中.它将存储查询本身、执行所需的时间以及调用它的函数.它也会对性能产生影响，因此如果您使用该插件，则应牢记这一点.如果以上内容对您来说意义不大，请知道这对您的体验没有太大影响.

安装插件后，您会注意到您可能还需要安装其他插件:

事实上，除非您是需要完成特定任务的开发人员，否则这些并不是必需的.

插件选项很少，这有助于提高可用性.您可以在 Tools > 下找到设置.WordPress 中的 WP Debugging 菜单，共有三个选项:

启用 WP_DEBUG.
将 WP_DEBUG_DISPLAY 设置为 false.这将在您的网站上显示或隐藏通知，与您是否记录错误无关.
将 WP_DISABLE_FATAL_ERROR_HANDLER 切换为 true.如果您不知道这意味着什么，您应该忽略它，因为它会更频繁地导致 WSoD.

如果您想查看日志，可以通过调试快速查看菜单进行: