菜鸟笔记
提升您的技术认知

WordPress调试模式

在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 文件中还可以配置其他与调试相关的选项,以满足不同的调试需求:

  1. 错误日志记录
    在开启调试模式的基础上,可以将错误信息记录到日志文件中,方便后续查看和分析。在 wp-config.php 文件中添加以下代码:
define( 'WP_DEBUG_LOG', true );

这样,WordPress 会将调试信息记录到 wp-content/debug.log 文件中。

  1. 显示调试信息
    默认情况下,调试信息会直接显示在页面上,这可能会影响网站的正常显示。可以通过以下配置关闭页面上的调试信息显示,只将信息记录到日志文件中:
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
  1. 禁止插件和主题编辑器
    在调试模式下,为了避免意外修改插件或主题文件,可以禁止插件和主题编辑器。在 wp-config.php 文件中添加以下代码:
define( 'DISALLOW_FILE_EDIT', true );

调试模式能提供的信息

  1. 错误和警告信息
    当 WordPress 遇到错误或警告时,调试模式会将这些信息显示在页面上(如果 WP_DEBUG_DISPLAY 设置为 true)或记录到日志文件中。例如,PHP 语法错误、数据库连接错误等都会以详细的信息呈现,帮助开发者快速定位问题所在。
  2. 查询日志
    调试模式还可以记录数据库查询信息,包括查询的 SQL 语句、查询执行的时间等。这对于优化数据库查询性能非常有帮助。可以使用一些插件(如 Debug Bar、Query Monitor 等)来更方便地查看查询日志。
  3. 钩子和过滤器信息
    WordPress 广泛使用钩子(Hooks)和过滤器(Filters)来扩展功能。调试模式可以显示哪些钩子和过滤器被触发,以及它们的执行顺序和传递的参数,有助于开发者理解插件和主题的工作原理。