WordPress 主题开发和调试巧用 debug 模式

官方：

https://codex.WordPress.org/WP_DEBUG

WP_DEBUG 是一个 PHP 常量（永久全局变量），可用于在整个 WordPress 中触发“调试”模式。默认情况下，它假定为 false，并且通常在 WordPress 的开发副本上的 wp-config.php 文件中设置为 true 。

有关 WordPress 中内置的其他调试工具的信息，请参阅 WordPress 中的调试

来源于：

https://www.nicetheme.cn/WordPress-zhu-ti-kai-fa-he-tiao-shi-qiao-yong-debug-mo-shi.html

一般来说，我们在开发 WordPress 主题的时候，都会开启 WordPress 的 Debug 模式（调试模式），以便检测出主题是否存在 bug。

在一般的主题使用中，这个 Debug 模式对于新手来说是不需要开启的。但如果在启动主题的后，前端页面显示存在问题、后台无法显示、出现 404、500 错误提示等情况时，巧用 Debug 调试模式，即可查看到底错误出现哪里。

开启 Debug 模式后，如果页面存在错误，一般会这样显示：

1
  Notice: 自3.1版本起，已不建议给WP_Query传入一个参数！“caller_get_posts”不再被建议使用。请改用“ignore_sticky_posts”。 in F:\wamp64\www\su\wp-includes\functions.php on line 3737

下面就为大家简单介绍一下开启的方法，在 WordPress 根目录下的 wp-config.php 文件大概 79 行下有下面一段代码：

1
  /**
2
 * 开发者专用：WordPress调试模式。
3
 *
4
 * 将这个值改为true，WordPress将显示所有用于开发的提示。
5
 * 强烈建议插件开发者在开发环境中启用WP_DEBUG。
6
 */
7
define('WP_DEBUG', false);

你只需要将 false 修改成 true，然后保存修改，就可以开启调试模式。

来源于：

https://premium.wpmudev.org/blog/debugging-WordPress-how-to-use-wp_debug/

在开始使用新的插件或主题之前，每个优秀的开发人员都应该打开调试。事实上，WordPress Codex “强烈建议”开发人员

WP_DEBUG

在处理他们计划公开发布的代码时使用模式。

不幸的是，许多开发人员不遵循这个建议只是因为他们忘记了 WordPress 内置的调试工具或者只是不知道如何使用它们。

在这篇文章中，我将介绍可用的基本调试工具，并向您展示它们的易用性。

编者注：这篇文章于 2013 年首次发布，但我们已经更新了内容，因此现在是 2017 年的最新内容。享受！

使用 WP_DEBUG 进行调试

您需要了解的最重要的调试工具是 WP_DEBUG。

WP_DEBUG 是一个布尔常量，它在整个 WordPress 中触发“调试”模式。它位于 WordPress 安装中的 wp-config.php 文件中。

当设置为“true”时，您将开始看到 PHP 通知 - 没有那么多错误，因为它们对于开发人员来说是有用的消息 - 以及 WordPress 生成的调试消息，特别是已弃用的功能使用，显示在您网站的页面上。

许多 WordPress 版本中包含的不推荐使用的函数是已被标记为在以后死亡的函数。重要的是要知道您是否在正在使用的主题或插件中使用已弃用的功能，以便您可以找到替代使用的替代品。

要打开 WP_DEBUG，请在 wp-config.php 文件中找到以下代码行：

1
define（'WP_DEBUG'，false）;

由 GitHub 用❤托管的

原始

wp-config.php

查看

然后，替换false与true和保存文件。

要关闭常数，只需将“true”替换为“false”即可。默认情况下，WP_DEBUG 设置为 false。

WP_DEBUG 提供了一种方便的方法来解决您的网站出现问题时的问题。

请记住，WP_DEBUG 不应在实际站点上使用，这一点很重要  。虽然它在开发过程中是一个有用的功能，但它在现场网站上可能会很危险，因为 PHP 通知中的文本可以向您网站的访问者显示有关您的代码，路径和其他信息的详细信息。

使用 WP_DEBUG_LOG 记录错误

另一个方便的工具是WP_DEBUG_LOG，它可以与WP_DEBUG将所有错误消息保存到 debug.log 文件一起使用。

如果您想稍后查看通知，这是一个特别有用的功能。

要打开调试日志记录，只需将以下代码行添加到 wp-config.php 文件中：

1
define（'WP_DEBUG_LOG'，true）;

查看

由 GitHub 用❤托管的

原始

访问 Debug.log 文件

添加上面的行后，您可以找到位于站点的/ wp-content /目录中的 debug.log 错误日志。您可以通过 SSH，FTP 或 cPanel 中的文件管理器访问此目录。

登录到 cPanel 后，转到“ 文件”>“文件管理器”。

导航到站点的根目录，然后单击/ wp-content /文件夹。如果发生错误，您应该看到列出了 debug.log。单击它，然后单击顶部菜单中的“ 查看”或“ 下载”按钮。

如果单击“ 查看”，则可以直接在浏览器中查看错误消息。如果您需要将其传递给插件或主题作者或我们的免费专家 24/7 支持团队，您可以下载该文件。

使用 WP_DEBUG_DISPLAY 关闭在您的站点上显示错误

如果您不希望将错误消息发布到您网站的页面，则应使用 WP_DEBUG_DISPLAY。

这是另一个有用的常量，它允许您控制调试消息是否显示在站点的 HTML 中。

默认值为“true”，显示生成时的错误和警告。将其更改为“false”将隐藏所有错误。

此常量应与 WP_DEBUG_LOG 一起使用。

要使用他的功能，只需将以下代码行添加到 wp-config.php 文件中：

1
define（'WP_DEBUG_DISPLAY'，false）;

查看

由 GitHub 用❤托管的

原始

把它放在一起

如果您想打开调试并记录错误消息但隐藏您网站上显示的通知，则可以轻松地将所有三个常量一起使用：

1
//打开调试define（'WP_DEBUG'，true）;
2
//告诉WordPress将所有内容记录到/wp-content/debug.logdefine（'WP_DEBUG_LOG'，true）;
3
//关闭您网站上的错误消息显示define（'WP_DEBUG_DISPLAY'，false）;
4
//为了更好地衡量，您还可以添加以下代码，这将隐藏屏幕上显示的错误@ini_set（'display_errors'，0）;

展开代码

查看

由 GitHub 用❤托管的

原始

不要忘记 WP_DEBUG  用于本地开发，  不应在实时站点上使用。