在WordPress网站上打开调试模式( WP_DEBUG )可以使您更好地了解网站正在发生的事情,尤其是当你的网站出现问题时。WordPress调试模式对于主题、插件开发者或者网站开发人员来说,非常有用。
开启 WordPress 调试模式
开启调试模式需要修改 WordPress 根目录下的 wp-config.php 文件。找到该文件后,使用文本编辑器(如 vim、nano 等)打开它,并在文件中找到以下代码块:
define( 'WP_DEBUG', false );
将 false 修改为 true,即:
define( 'WP_DEBUG', true );
保存文件后,WordPress 调试模式就开启了。
调试模式的配置选项
除了基本的调试模式开启外,wp-config.php 文件中还可以配置其他与调试相关的选项,以满足不同的调试需求:
- 错误日志记录
在开启调试模式的基础上,可以将错误信息记录到日志文件中,方便后续查看和分析。在 wp-config.php 文件中添加以下代码:
define( 'WP_DEBUG_LOG', true );
这样,WordPress 会将调试信息记录到 wp-content/debug.log 文件中。
- 显示调试信息
默认情况下,调试信息会直接显示在页面上,这可能会影响网站的正常显示。可以通过以下配置关闭页面上的调试信息显示,只将信息记录到日志文件中:
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
- 禁止插件和主题编辑器
在调试模式下,为了避免意外修改插件或主题文件,可以禁止插件和主题编辑器。在 wp-config.php 文件中添加以下代码:
define( 'DISALLOW_FILE_EDIT', true );
调试模式能提供的信息
- 错误和警告信息
当 WordPress 遇到错误或警告时,调试模式会将这些信息显示在页面上(如果 WP_DEBUG_DISPLAY 设置为 true)或记录到日志文件中。例如,PHP 语法错误、数据库连接错误等都会以详细的信息呈现,帮助开发者快速定位问题所在。 - 查询日志
调试模式还可以记录数据库查询信息,包括查询的 SQL 语句、查询执行的时间等。这对于优化数据库查询性能非常有帮助。可以使用一些插件(如 Debug Bar、Query Monitor 等)来更方便地查看查询日志。 - 钩子和过滤器信息
WordPress 广泛使用钩子(Hooks)和过滤器(Filters)来扩展功能。调试模式可以显示哪些钩子和过滤器被触发,以及它们的执行顺序和传递的参数,有助于开发者理解插件和主题的工作原理。