Skip to content

v1.0.0

Choose a tag to compare

View all tags
@superdav42 superdav42 released this 02 Mar 19:50
· 67 commits to main since this release
v1.0.0
eda9406

WP Queue Worker v1.0.0

Event-loop job queue for WordPress. Executes WP Cron and Action Scheduler jobs at their exact scheduled time with zero polling, powered by Workerman.

Features

  • Precise scheduling: Jobs fire at exact timestamps via Workerman's event loop — no cron polling
  • Multisite support: Scans all network sites, executes jobs in isolated per-site subprocesses
  • Action Scheduler bridge: Takes over AS job execution for millisecond-precision scheduling
  • WP Cron interception: Intercepts wp_schedule_event and dispatches to the worker instantly
  • Batch execution: Groups jobs by site for efficient subprocess reuse
  • Admin dashboard: Real-time worker status, per-site resource usage, job history table, log viewer
  • WP-CLI commands: wp queue status, wp queue populate, wp queue restart
  • Configurable: All settings via PHP constants or environment variables
  • Auto-restart: Memory and uptime watchdog for systemd-managed deployments

Architecture

  • OOP codebase: 12 PHP classes with Composer classmap autoloading
  • Two Composer contexts: Plugin root (WordPress classes) + bin/ (Workerman dependency)
  • Thin CLI bootstraps: bin/worker.php (~80 lines) and bin/execute-job.php (~90 lines)
  • Build system: npm scripts for CSS/JS minification + distribution archive

Requirements

  • PHP 8.1+
  • WordPress multisite (or single site)
  • Composer
  • proc_open and pcntl PHP extensions (for subprocess execution and per-job timeouts)

Installation

Composer (recommended):

composer require ultimate-multisite/wp-queue-worker
cd wp-content/plugins/wp-queue-worker/bin && composer install

Manual:
Download the release zip and extract to wp-content/plugins/.

Assets 2
Loading