Npcink Blog
切换菜单

Query Monitor – WordPress 的开发人员工具面板

Query Monitor 是 WordPress 和 WooCommerce 开发者专用调试工具面板。该插件支持调试数据库查询、PHP 错误、钩子和动作、块编辑器、脚本样式表及 HTTP API 调用等功能。主要特性包括：按插件/主题分类聚合数据库查询、模板文件分析、PHP 错误追踪、HTTP 请求监控、用户权限检查等。它兼容 WordPress 近三年版本，要求 PHP 7.4+，输出信息默认仅对管理员可见。特别提供 Ajax 调试、REST API 监控能力，并能通过 HTTP 标头输出重定向和错误信息。面板采用可视化方式呈现性能数据，帮助快速定位插件或主题的性能问题。

最后更新于
本页目录2 节

Query Monitor 是 WordPress 和 WooCommerce 的开发人员工具面板。它支持调试数据库查询、PHP 错误、钩子和作、块编辑器块、排队脚本和样式表、HTTP API 调用等。

它包括一些高级功能，例如 Ajax 调用调试、REST API 调用、用户功能检查以及对块主题和完整站点编辑的完全支持。它包括按插件或主题缩小大部分输出范围的能力，使您能够快速确定性能不佳的插件、主题或功能。

Query Monitor 非常注重以有用的方式呈现其信息，例如，通过显示按负责它们的插件、主题或函数分组的聚合数据库查询。它添加了一个管理工具栏菜单，显示当前页面的概述，一旦您选择菜单项，面板上会显示完整的调试信息。

给 WordPress 的主题和插件开发者用的，没事别装这个

Query Monitor 支持长达三年的 WordPress 版本，以及 PHP 版本 7.4 或更高版本。

功能概述

  • 数据库查询，包括查询缓慢、重复或错误的查询通知。允许按查询类型（、、 等）、负责组件（插件、主题、WordPress 核心）和调用函数进行筛选，并为每个组件提供单独的聚合视图。SELECTUPDATEDELETE

  • 模板文件名、完整的模板层次结构以及已加载或未加载的所有模板部分的名称（适用于块主题和经典主题）。

  • PHP 错误及其负责的组件和调用堆栈以及管理工具栏中的可见警告都很好地呈现了出来。

  • 在站点代码中使用“Doing it Wrong”或“Deprecated”功能。

  • 帖子内容和完整站点编辑 （FSE） 中的块和关联属性。

  • 匹配的重写规则、关联的查询字符串和查询变量。

  • 排队的脚本和样式表，以及它们的依赖项、依赖项和损坏的依赖项警报。

  • 每个文本域的语言设置和加载的翻译文件（MO 文件和 JSON 文件）。

  • HTTP API 请求，包含响应代码、负责的组件和所用时间，以及请求失败或错误的警报。

  • 用户能力检查，以及结果和传递给能力检查的任何参数。

  • 环境信息，包括有关 PHP、数据库、WordPress 和 Web 服务器的详细信息。

  • 所有 WordPress 条件函数的值，例如 、 等。is_single()is_home()

  • 已更新的 Transients。

  • 多站点安装的使用情况 和 上。switch_to_blog()restore_current_blog()

另外：

  • 每当发生重定向时，Query Monitor 都会添加一个包含调用堆栈的 HTTP 标头，因此您可以使用自己喜欢的 HTTP 检查器或浏览器开发人员工具来跟踪触发重定向的原因。

  • 页面上任何 jQuery 发起的 Ajax 请求的响应都将在其标头中包含各种调试信息。PHP 错误也会输出到浏览器的开发人员控制台。

  • 只要经过身份验证的用户有权查看 Query Monitor 的输出，来自经过身份验证的 WordPress REST API 请求的响应将在其标头中包含性能信息和 PHP 错误的概述。一个信封的 REST API 请求将在响应的属性中包含更多的调试信息。qm

默认情况下，查询监视器的输出仅对单站点安装的管理员和多站点安装的超级管理员显示。

除此之外，您还可以设置身份验证 Cookie，该 Cookie 允许您在未登录时（或者以非管理员身份登录）查看 Query Monitor 输出。有关详细信息，请参阅 Settings 面板。

效果预览

数据库查询

功能检查

按组件聚合数据库查询

钩子和动作

HTTP API 请求