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

尽管 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 调试模式,有两种典型的方法:

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

1.通过wp-config.php文件

启用调试模式

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

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

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

完成这些设置后,请通过 SFTP 登录您的站点.如果您只运行一个站点,根目录(也称为 wwwpublic_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.

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

该插件是一种无需深入研究核心文件即可调试站点的便捷方式,因此值得安装.当然,您需要在完成后卸载插件或停用选项,就像手动方法一样.

总结

WordPress 网站出现故障的情况很少见,或者至少当它确实发生时您能够修复它.大多数主要错误通过您网站上的通知或加载网站时的页面显示出来.不过,您可能需要了解许多其他"无声"错误或顾虑,尤其是如果您是开发人员.

在这篇文章中,我们为您提供了两种激活 WordPress 调试模式的方法.他们又来了:

  • 使用 SFTP 打开您的 wp-config.php 文件并添加几行代码.
  • 安装插件,例如 WP 调试 并麻烦地记录您的错误-免费的方法.

您是否需要使用 WordPress 调试模式,这篇文章对您有帮助吗?在下面的评论部分告诉我们!

1
订阅评论
提醒
0 评论
内联反馈
查看所有评论