跳转到正文

调试模式

以 Markdown 格式查看 在 GitHub 上编辑 文档位置 2cc7b2b

在开发期间启用调试模式，以输出详细的工作进程日志。启用后，工作进程会记录每项任务的领取、执行和状态转换的额外信息。

启用调试模式

在 wp-config.php 中定义常量：

PHP
define( 'QUEUETY_DEBUG', true );

功能说明

启用调试模式后：

  • 工作进程会将 LogEvent::Debug 条目写入日志表，记录领取尝试、空队列、资源准入延迟、调度器节拍、速率限制检查和取消领取、任务类反序列化以及处理程序解析
  • 每条调试记录的上下文中都包含处理程序 _worker、队列和 message；任务开始、完成和失败本来就会作为常规事件记录

检查调试状态

PHP
use Queuety\Config;

if ( Config::debug() ) {
    // Debug mode is active
}

适用场景

  • 开发期间。 跟踪任务和工作流的完整生命周期，以验证行为。
  • 故障排查。 获取任务失败或工作流停滞原因的详细上下文。
  • 性能调查。 将调试记录与常规 completed 事件的 duration_ms 和 指标 API结合分析。

在生产环境中禁用调试模式，以免大量调试条目填满日志表。调试条目会一直保留，直到你通过 Queuety::purge_logs() 清除日志；系统不会自动清除它们。