调试WordPress:如何使用wp_debug


每一个良好的开发人员都应该在开始新的插件或主题之前打开调试.事实上,WordPress Codex"高度推荐"开发人员使用WP_DEBUG
模式,同时在他们计划公开发布的代码上.
不幸的是,许多开发人员不要仅仅因为他们忘记了对Wordpress内置的调试工具或者只是不知道如何使用它们而追踪此建议.
在这篇文章中,我将通过可用的基本调试工具,并向您展示他们使用的容易.
- 用wp_debug调试
- 使用wp_debug_log记录错误
- 访问debug.log文件
- 关闭站点上的显示错误与wp_debug_display
- 将其全部放在一起
使用wp_debug调试
您需要了解的最重要的调试工具是 WP_Debug .
wp_debug 是一个布尔常数,它触发了整个WordPress的"调试"模式.它位于WordPress安装中的 wp-config.php 文件中.
当设置为"true"时,您将开始看到PHP注意事项-没有这么多错误,因为它们是开发人员的有用消息-以及WordPress生成的调试消息,特别弃用的函数使用,在您的网站上显示.
已弃用的函数包含在许多Wordpress版本中,是在以后被标记为死在一起的函数.重要的是要知道您是否在您正在处理的主题或插件中使用已弃用功能,因此您可以找到更换使用.
要打开wp_debug,请在 wp-config.php 文件中找到以下代码行:
加载GIST 1B61C6A012F69190264E22782C66824
然后,用true
替换false
并保存文件.
要熄灭,只需用"false"替换"true".默认情况下, wp_debug 设置为false.
wp_debug 为您的网站出现问题时提供了一种易于解决问题的方便方式.
要记住 wp_debug 不应在直播网站上使用.虽然它在开发过程中是一个有用的功能,但它可以在现场网站上危险,因为PHP注意事项中的文本可以向访问者透露有关您的代码,路径和其他信息的详细信息.
使用wp_debug_log
日志记录错误
另一个方便的工具是WP_DEBUG_LOG
,它可以与WP_DEBUG
一起使用,以将所有错误消息保存到 debug.log 文件.
如果您想稍后查看通知,这是一个特别有用的功能.
要打开调试日志记录,只需将以下代码行添加到您的 wp-config.php 文件:
加载GIST 714A617E37D1A7936393FD51CF58E8BE.
访问 debug.log 文件
一旦添加上面的行,您可以找到位于您网站的/WP-Content/目录中的 Debug.log 错误日志.您可以通过CPanel中的SSH,FTP或文件管理器 访问此目录.
登录cpanel后,转到文件>文件管理器.

导航到站点的根目录,然后单击/wp-content/文件夹.如果发生错误,则应查看 debug.log 列出.点击它,然后在查看或下载按钮上朝上顶部.

如果单击视图,则可以直接在浏览器中看到错误消息.如果您需要将其传递给插件或主题作者或我们的免费专家24/7支持团队,您可以下载该文件.
关闭站点上的显示错误与wp_debug_display
如果您不希望发布到您的网站页面的错误消息,则应使用 WP_Debug_Display .
这是另一个有用的常量,它允许您控制在网站的HTML中是否显示调试消息.
默认值为"true",它显示了生成时的错误和警告.将其更改为"false"将隐藏所有错误.
此常数应与 wp_debug_log 结合使用.
要使用他的功能,只需将以下代码行添加到您的 WP-Config.php 文件:
加载GIST CA892F6002869FCCBBDE6023E86D34B0
将其全部放在一起
如果您想打开调试和日志错误消息,则易于使用所有三个常量,但隐藏网站上显示的通知:
加载GIST 75FB311CC2C5D23FFB527DDF3D20557F.
别忘了 wp_debug 用于本地开发使用,不应该在实时站点上使用.
编辑器注意: 此帖子已更新以获得准确性和相关性.
[最初发布时间:2013年/修订:3月2022]