如何启用 WordPress 调试模式:2 种方法

已发表: 2021-10-21

您是否正在寻找解决网站冲突的方法? 找出问题的原因可以为您节省大量时间,因此,如果您对此感兴趣,这篇文章就是为您准备的。 在本指南中,我们将向您展示 2 种启用 WordPress 调试模式并在您的网站上查找冲突的方法。

不管你多么小心,如果你有一个网站,你总是会面临各种各样的问题。 对这些错误进行故障排除并不总是那么容易,您可能需要几个小时才能找到冲突的根源。 这就是为什么知道如何解决这些问题并解决它们是避免头痛的关键。 在本文中,您将学习如何在 WordPress 中启用调试模式并立即解决您的问题。

在我们进入之前,让我们更好地了解调试模式是什么。

什么是调试模式?

调试模式是开发人员用来识别由 PHP 或其他编程语言引起的潜在威胁和警告的一种技术。 您可能知道,WordPress 是使用 PHP、JavaScript、HTML 和 CSS 构建的,因此您可能会遇到一些由代码错误引起的错误。 例如,当您执行以下操作时,您的网站可能会受到威胁:

  • 更新 PHP 版本
  • 添加自定义代码
  • 安装新主题/插件
  • 更新您的主题/插件
  • 更新 WordPress

通常,您的插件会因为更新或不兼容而导致冲突。 问题千差万别,从无害的冲突到在结帐页面上制造问题,或者如果你不走运,就会出现死机白屏。 默认情况下,WordPress 没有内置功能来监控这些冲突,因此很难知道发生了什么。 好消息是您可以做一些事情来查看错误并在为时已晚之前修复它们。 这使您可以更准确地进行故障排除并更快地解决问题。

当您启用调试模式时,WordPress 将在顶部导航栏正下方的管理区域中显示每个错误。 这样,您可以快速关注警告并修复所需的任何内容。 即使不是每个错误都需要紧急关注,但一旦它们出现就立即修复它们将帮助您确保事情不会变得更糟,并提供出色的用户体验。

现在让我们看看激活调试模式的不同方法。

如何启用 WordPress 调试模式

您可以通过两种方式启用 WordPress 调试模式

  1. 手动
  2. 使用插件

在本节中,我们将向您展示这两种方法,以便您可以根据需要选择最好的一种。

1) 手动激活调试模式

如果您具有编码技能并且能够轻松编辑核心文件,那么此方法适合您。 要启用调试模式,您需要在wp-config.php文件中添加代码片段。 您可以使用 FileZilla 之类的 FTP 客户端或专用文件管理器插件。 对于此演示,我们将使用文件管理器插件。

注意:我们将进行的更改非常简单,但始终建议您在开始之前创建您网站的备份。

1.1) 安装并激活文件管理器

您需要做的第一件事是在您的 WordPress 安装中安装并激活文件管理器插件。 转到插件 > 添加新插件,搜索插件并安装它。

重定向 wordpress 页面 - 安装 wp 文件管理器

1.2) 插件配置

激活后,在WP File Manager下打开插件的设置。 在那里,您将看到服务器上托管的所有目录和文件。

文件管理器

在修改wp-config.php文件之前,我们建议您将其副本下载到本地计算机。 这样,如果出现任何问题,您可以轻松删除修改后的版本并上传父文件。 这样,您可以添加额外的预防措施。

下载 wp 配置文件

下载文件后,在文件管理器中右键单击wp-config.php文件并使用代码编辑器选项对其进行修改。

启用 wordpress 调试模式 - 文件管理器代码编辑器

1.3) 片段

打开它后,您将看到编辑器。 从那里,您可以添加或删除文件的代码。

启用 wordpress 调试模式 - 编辑 wp 配置

如果你滚动到底部,你会看到一行写着/* 就是这样,停止编辑! 快乐出版。 */. 复制以下代码并将其粘贴到该行之前。

 定义('WP_DEBUG',真);

该代码只是告诉 WordPress 启用调试模式。

保存 wp 配置文件

如果你的wp-config.php文件已经有这个片段,但是常量设置为 false,你不需要再次添加代码。 您需要做的就是将单词false更改为true

那不是全部。 这个片段的问题是它会在前端和后端显示您网站的所有冲突(如果有的话)。 这意味着如果您的网站是实时的,访问者将能够看到警报,这可能会使他们感到困惑。 没有办法隐藏它们吗? 就在这里! 此外,记录所有问题可能很方便。

1.4) 从前端隐藏警报的片段

要隐藏警报并保留日志,请使用以下代码段并将其粘贴到您刚刚添加的调试代码下方。

 // 将 debug.log 保存到 /wp-content/debug.log
定义('WP_DEBUG_LOG',真);

// 隐藏错误和警告
定义('WP_DEBUG_DISPLAY',假);
@ini_set('display_errors', 0);

创建调试日志

完成后,记得保存设置,就是这样! 您现在已经在 WordPress 中手动启用了调试模式。 从现在开始,您将能够密切关注警报,但您的网站访问者不会在前端看到它们。

如果您对这种方法不满意,还有另一种选择。

2) 使用插件启用调试模式

如果您不想编辑核心文件,可以使用插件激活调试模式。 在本节中,我们将逐步向您展示如何做到这一点。

WP Debugging 是一个专用插件,可在任何 WordPress 安装上启用调试模式。 在本节中,您将逐步学习如何进行操作。

2.1) WP调试的安装和激活

首先,您需要在您的网站上安装并激活 WP 调试插件。 此插件位于存储库中,因此,在您的管理仪表板中,前往Plugins > Add New ,查找插件并安装它。

启用 wordpress 调试模式 - 安装 WP 调试插件

2.2) 插件配置

安装并激活插件后,您将在“工具”部分下看到配置。

启用 wordpress 调试模式 - wp 调试设置

该插件会自动将此代码添加到您的wp-config.php文件中:

 定义('WP_DEBUG',真);
定义('WP_DEBUG_LOG',真);
定义('SCRIPT_DEBUG',真);
定义(“保存查询”,真);

此代码激活了调试模式。 只需勾选“将 WP-DEBUG 设置为 true”选项并保存更改。

这也会在前端显示错误,因此我们建议您也选择“ Set WP_DEBUG_DISPLAY to false, default is true”选项来隐藏警报。

之后,访问您有问题或冲突的一些网站页面,以确保这些消息不存在。 最后,您还可以检查debug.log文件中的错误消息。

这就是您可以使用插件在 WordPress 中启用调试模式的方法。 请记住,如果您卸载 WP Debugging,它添加的代码将被删除。

激活调试模式是第一步。 现在您需要知道如何检查错误消息,以便尽快修复它们。 让我们看看如何做到这一点。

如何检查错误信息

启用调试模式后,WordPress 将在您的服务器中存储每个问题的日志。 您可以使用 FTP 客户端或专用插件在文件管理器中找到日志。 在本节中,您将学习如何正确检查错误消息。

对于此演示,我们将使用文件管理器插件,但无论您选择哪种方法,您都可以按照说明进行操作。

首先,打开wp-content文件夹。 在那里,您将看到一个名为debug.log的新文件,其中包含所有错误的日志。

wp内容调试日志

打开文件,您将看到所有需要修复的错误及其日期和时间。

错误日志

注意:不建议在实时网站上启用调试模式和故障排除。 相反,您可以创建一个暂存环境并在那里进行所有必要的测试。 获得解决方案后,您可以将其应用于您的实时站点。 大多数 WordPress 托管公司都提供免费的临时环境用于测试和开发目的,所以这应该不难。

结论

总而言之,默认情况下,WordPress 没有内置功能来监控错误和冲突。 这使得了解问题所在并因此解决问题变得具有挑战性。

调试模式允许您发现错误和错误并快速修复它们。 在本指南中,我们看到了在 WordPress 中启用调试模式的两种不同方法:

  • 手动用一点代码
  • 带插件

如果您喜欢编辑核心文件,您可以使用几行代码手动激活调试模式。 这种方法很简单,不会影响您网站的速度和性能。 另一方面,您可以使用插件来激活调试模式,而无需编辑任何核心文件。 此方法非常适合初学者,因为它让您只需单击几下即可启动并运行调试模式。 两种方法都有效,因此请选择最适合您的要求和偏好的方法。

最后,如果您想学习解决一些最常见的 WordPress 问题,请查看以下指南:

  • WordPress登录不起作用? 如何修复它
  • 如何修复 WordPress 永久链接
  • 修复 WordPress 更新失败错误
  • 如何解决您关注的链接在WordPress中已过期错误

您是否在您的网站上启用了调试模式? 您使用了哪种方法? 在下面的评论中让我们知道!