在一个完美的世界中,您永远不会遇到需要调试的问题。但在现实世界中,您几乎肯定会在WordPress网站上遇到需要深入了解的问题。
为了帮助您做到这一点,WordPress包含其自己的内置调试模式,您还可以找到有用的第三方工具来帮助您调试WordPress。
在这篇文章中,我们将深入研究内置的WordPress调试模式并向您展示如何启用它。然后,我们还将分享其他一些调试WordPress网站的方法。
这是我们将涵盖的所有内容:
- WordPress调试模式和调试日志介绍
- 如何启用WordPress调试模式(三种方法)
- 调试WordPress的其他一些方法
WP Debug有什么作用?
核心WordPress软件是用PHP编写的,插件和主题也是如此。
如果您的网站出现问题,WordPress Debug模式可以通过显示所有PHP错误、通知和警告来帮助您找出问题所在。
启用Debug模式后,只要出现问题(即使它不会立即引起问题),您就会看到如下消息:
WordPress网站上的WP_DEBUG错误示例
然后,您可以修复问题或将其报告给您的开发人员或主题/插件的开发人员。
什么是WordPress调试日志?
当你本身启用WordPress的调试模式,你会看到的消息像上面网站上的例子在那一刻-但这些消息不会被保存任何地方。
如果您想保存它们,您还可以启用WordPress调试日志以将所有这些消息和错误保存到您服务器上的文件中。
通过将WP_DEBUG_LOG
常量设置为true启用后,WordPress会将所有问题写入以下文件:
wp-content/debug.log
但是,您也可以指定自定义文件路径以将日志写入服务器上的其他位置。
如果您想将问题保存到日志中但不想在页面的HTML中公开显示它们(如上面的示例屏幕截图),您还可以使用WP_DEBUG_DISPLAY
常量来保持启用调试模式但不在您的站点上显示消息。
通常,您需要WP_DEBUG_DISPLAY
与WP_DEBUG_LOG
.
如何启用WordPress Debug模式
要启用WordPress调试模式,您有多种选择。我们将介绍三种启用它的方法:
- 如何使用WordPress调试插件
- 如何手动启用WordPress调试模式
如何使用WordPress调试插件
您可以使用免费的WordPress调试插件,启用调试模式。WordPress.org上有几个选项,但我们推荐Andy Fragen提供的免费WP Debugging插件。
WP Debugging插件
安装并激活插件后,它会立即开始工作。默认情况下,它将以下常量设置为true(即启用以下功能):
WP_DEBUG
– 启用调试模式。WP_DEBUG_LOG
– 将消息保存到日志文件。SCRIPT_DEBUG
SAVEQUERIES
我们将在本文稍后介绍最后两个常量的作用。
要配置一些选项,您可以转到工具 → WP Debugging:
WP Debugging插件设置
完成后,请确保禁用插件以禁用调试模式。
如何手动启用WordPress调试模式
最后,您还可以通过手动将常量添加到wp-config.php文件来启用WordPress调试模式。
首先,通过FTP连接到您的服务器并编辑wp-config.php文件。默认情况下,此文件位于您站点的根文件夹中(除非您出于安全原因移动了它)。
要启用只是基本的WordPress的调试模式,添加下面的代码片段上面写着/* That’s all, stop editing! Happy blogging. */:
// Enable WP_DEBUG modedefine( 'WP_DEBUG', true );
您还可以根据自己的喜好使用以下一些常量:
// Enable Debug logging to the /wp-content/debug.log filedefine( 'WP_DEBUG_LOG', true );// Disable display of errors and warningsdefine( 'WP_DEBUG_DISPLAY', false );@ini_set( 'display_errors', 0 );
完成后,您可以将常量设置为false或仅删除代码段以禁用调试模式。
确保在完成后禁用WordPress中的调试模式
调试模式在您尝试解决WordPress问题时很有用,但您不应该让它24/7全天候启用,因为它可以将您的PHP代码中的文本显示给网站访问者。
我们在上面提到了这一点 – 但这只是提醒您在完成故障排除后始终禁用调试模式。
其他调试WordPress的方法
除了我们上面介绍的内置调试工具之外,还有其他几个内置和第三方工具可以帮助您调试WordPress网站。
脚本调试
SCRIPT_DEBUG
是另一个内置常量,它强制WordPress使用核心CSS和JavaScript文件的开发版本,而不是它通常加载的缩小版本。
如果您正在测试对内置 .js 或.css文件的更改,这会很有帮助。
要启用SCRIPT_DEBUG
,您可以:
- 使用上面的免费WP Debugging插件,默认情况下启用它。
- 将以下常量添加到您的wp-config.php文件中 –
define( 'SCRIPT_DEBUG', true );
数据库查询调试
如果您的站点的数据库有问题,您可以使用SAVEQUERIES
常量来启用数据库查询日志记录:
- 每个数据库查询。
- 调用数据库查询的函数。
- 查询用了多长时间。
要启用查询日志记录,您可以:
- 使用上面的免费WP Debugging插件,默认情况下启用它。
- 将以下常量添加到您的wp-config.php文件中 –
define( 'SAVEQUERIES', true );
注意:这会影响您网站的性能,因此请尽可能在临时网站上使用它,并在完成后立即将其禁用。
Query Monitor插件
Query Monitor插件是一个免费的插件,这对在WordPress包括调试许多不同的领域有所帮助:
- 数据库查询。
- PHP错误。
- 钩子和动作。
- 古腾堡编辑器区块。
- 排队的脚本和样式表。
- HTTP API调用。
- 用户功能。
总的来说,它是您能找到的最好的WordPress调试工具之一,这就是为什么它在320多条评论中几乎获得了完美的5星评级。
安装并激活插件后,您将在WordPress工具栏上获得一些显示调试信息的新选项。单击后,这些选项将打开一个新的Query Monitor框,为您提供更多信息:
Query Monitor插件
为了更详细地了解,我们有一整篇关于如何使用Query Monitor插件的文章。
New Relic
New Relic是用于分析和调试站点性能的高级工具。它可以帮助您发现影响站点性能的瓶颈和问题。
服务器日志
最后,您的服务器日志也可以成为调试WordPress的有用工具。
如果您在使用宝塔面板,也可以轻松查询服务器日志,参考宝塔面板日志查阅教程。
小结
如果您需要调试WordPress,内置的WordPress调试模式提供了一种查看PHP错误和通知的有用方法。
您可以使用插件或通过将代码片段添加到您网站的wp-config.php文件来启用它。
如需更多帮助,您还可以使用其他内置工具或第三方工具,例如New Relic和免费的Query Monitor插件。