NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #4137 most downloaded on Packagist
The Queue plugin for CakePHP provides deferred task execution.
Latest stable
8.18.0
Last release 18 days ago
03 Nov 2026
Release timing varies
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
139 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
### Fixes Reverted BC breaks.
Reverted BC breaks.
Fixed deprecations by @LordSimal in https://github.com/dereuromark/cakephp-queue/pull/326
Full Changelog: https://github.com/dereuromark/cakephp-queue/compare/6.3.2...6.4.0
Fixing Error on SQLSERVER related to Datediff by @PauloPeres in https://github.com/dereuromark/cakephp-queue/pull/322
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/dereuromark/cakephp-queue/compare/6.3.1...6.3.2
Fixed admin backend template - by @passchn in https://github.com/dereuromark/cakephp-queue/pull/321
Full Changelog: https://github.com/dereuromark/cakephp-queue/compare/6.3.0...6.3.1
Allow info logging for all cases except quiet mode by @dereuromark in https://github.com/dereuromark/cakephp-queue/pull/316
Full Changelog: https://github.com/dereuromark/cakephp-queue/compare/6.2.2...6.3.0
Fixed EmailTask to work with Cake\Mailer\Message object as expected, alongside the other ways it already supports.
Fixed EmailTask to work with Cake\Mailer\Message object as expected, alongside the other ways it already supports.
Fix up deprecation of helper/engine.
Fix up deprecation of helper/engine.
Note: CakePHP 4.2+ and PHP 7.3+ now, also requires Tools 2.4+ if backend is used
Note: CakePHP 4.2+ and PHP 7.3+ now, also requires Tools 2.4+ if backend is used
Added TaskFinder::getClass() to resolve a name to a task class.
Added TaskFinder::getClass() to resolve a name to a task class.
### Fixes Fixed small notice.
Fixed small notice.
Relaxed check for task existence when calling createJob(). An option can now disable this if needed.
createJob().
An option can now disable this if needed.Decoupled from old Shell/Task system as well as proxied to ConsoleIo using Io adapter class to avoid direct coupling
Io adapter class to avoid direct couplingMyTask vs MyPlugin.MyTask)FQCN::class usage via QueuedJobsTable::createJob()action keybin/cake overview for details.Added "Reusable emails support" for Email task using action key
action keyPlease help to test and stabilize.
A pre-release for the new major v6.
A pre-release for the new major v6.
bin/cake overview for details.Please help to test and stabilize.
Allows interrupting worker's sleep() with SIGUSR1
sleep() with SIGUSR1Updated icons to fontawsome 5. If you need to retain the old ones, you can easily alias them via Tools plugin config.
Updated icons to fontawsome 5. If you need to retain the old ones, you can easily alias them via Tools plugin config.
Fixed return types for search functionality.
Fixed return types for search functionality.
Better logging and debugging for execute tasks.
Fixed Email task for non templating emails together with latest Tools release.
Added missing helpers for Controller
### Fixes Stability now stable.
Stability now stable.
Fixed email queue task for Mailer objects.
Fixed email queue task for Mailer objects.
A standalone queue solution for CakePHP apps.
A standalone queue solution for CakePHP apps.
To make sure the signatures of the Tasks are up to date, run any regexp or changeset over it, similar to the following sed command:
sed -i 's|public function run(array $data, $id) {|public function run(array $data, int $id): void {|g' src/Shell/Task/*Task.php
Dont' forget to add implements AddInterface if the add() method is supported/included in that task.
Basic Queue email functionality re-enabled. Included also 4.3.0 improvements around requeue and status display/info.
Basic Queue email functionality re-enabled. Included also 4.3.0 improvements around requeue and status display/info.
Please help to finalize for stable release.
Please help to finalize for stable release.
### Fixes Small CakePHP 3 fixes
Small CakePHP 3 fixes
Backported a CakePHP 4.x branch feature of auto-using from if configured (using Configure Config.adminEmail value). Also allow easier testing of Email
Backported a CakePHP 4.x branch feature of auto-using from if configured (using Configure Config.adminEmail value).
Also allow easier testing of Email task now.
Fixed re-queuing to be allowed to force-reset quicker.
Fixed re-queuing to be allowed to force-reset quicker.
Removed deprecations, the plugin now requires CakePHP 3.8+. Note: The changes mean you can now no longer call any method on the Email tasks using setX…
Better display of failure count and requeue-status.
Removed deprecations, the plugin now requires CakePHP 3.8+.
Note: The changes mean you can now no longer call any method on the Email tasks using setX string config keys. It will auto prefix each setter with set. So setTo should be/stay to.
Fixed display of reset buttons on QueuedJob view page.
Added separation for resetting jobs: failed only or all.
Added separation for resetting jobs: failed only or all.
Added a redirect functionality for reset and remove actions. This way you can use them from your application directly.
Added a redirect functionality for reset and remove actions. This way you can use them from your application directly.
Refactored IdeHelper generator tasks for new 0.14.0 compatibility.
Refactored IdeHelper generator tasks for new 0.14.0 compatibility.
Added self-healing during queue worker-run.
Added self-healing during queue worker-run.
You can now use HTML5 progress bar (easier to style using CSS). For this it is recommended to add the textual one from above as fallback, though: `php
You can now use HTML5 progress bar (easier to style using CSS). For this it is recommended to add the textual one from above as fallback, though:
$textProgressBar = $this->QueueProgress->progressBar($queuedJob, 18);
echo $this->QueueProgress->htmlProgressBar($queuedJob, $textProgressBar);
The textual bar will only be visible for older browsers that do not support the HTML5 tag.
The same goes for the timeout progress bars.
$textTimeoutProgressBar = $this->QueueProgress->timeoutProgressBar($queuedJob, 18);
echo $this->QueueProgress->htmlTimeoutProgressBar($queuedJob, $textTimeoutProgressBar);
For details see docs.
Fixed PostgreSQL support for requestJob().
Travis is now fully active and passing for this DB type.
### Bugfixes Fixed progress display.
Fixed progress display.
DB only queue (removed PID file solution and deprecations)
This is a BC breaking major for use with CakePHP 3.7+.
Please see Wiki for version map.
DB only queue (removed PID file solution and deprecations)
This is a BC breaking major
Please see Wiki for version map.
Fix deprecated use of files for BC reasons
Added configurable return code check into Execute task. Added some better docs here, too.
Using Queue.multiserver config you can now have the correct behavior per environment from both CLI and web backend.
Using Queue.multiserver config you can now have the correct behavior per environment from both CLI and web backend.
Added a re-run option for successfully run jobs on CLI Just execute
bin/cake queue rerun MyTask {reference}
The optional reference can be an additional filter for specific jobs of this task.
Please note: The API for reset() has slightly changed, but usually no one is directly using the result here. It now returns the changed/touched rows (int) instead of boolean success.
Fix local development and kill commands (Ctrl+C etc) to properly abort the queue worker process. Depending on your deployment process this could also
Added maxworkers config to set the max amount of workers per server. If not set or 0 it will behave as before, but with this > 0 it will assert that a
Added maxworkers config to set the max amount of workers per server. If not set or 0 it will behave as before, but with this > 0 it will assert that a cronjob cannot start more workers than currently running. It includes workers that died improperly to ensure this cannot bypass bottleneck situations where workers got marked as "to be stopped" but are still running some background script for minutes more.
Based on your memory and the jobs you are running you can estimate how many workers in parallel are the maximum you want to allow. This helps to prevent "Fatal error: Out of Memory" situations or other long-running jobs in parallel overloading your server (load >> 1).
It is now easier to export failed jobs and import them locally to re-run there for debugging. You can import them as-is, or auto-resetted.
Validation requirePresence('workerkey') added for processes
Removed deprecations, CakePHP 3.7+ now.
You can now run multiple worker servers:
env('SERVER_NAME') or gethostname() return a unique name per server instance.bin/cake queue end in the deployment script by shutting down active workers early. Either all (bin/cake queue end -q), or by server instance (bin/cake queue end server -q ).To migrate make sure you execute this once all workers have been terminated (no active processes):
bin/cake migrations migrate -p Queue
Limit the error output on the overview page.
getOrFail() usage where required/needed.
Queue.configLoaded is found.queue settings command to display currently running jobs.Consistent FrozenTime usage for datetime handling to prevent timezone issues (DB vs PHP) for delayed jobs.
isStatisticEnabled config.CakePHP 3.6+, deprecations removed
Fixed exclude lists for types or groups.
Make sure that if a process gets stuck, e.g. in some exec() forever running code, that the crontab doesnt built up too many never-ending workers runni
Make sure that if a process gets stuck, e.g. in some exec() forever running code, that the crontab doesnt built up too many never-ending workers running and then killing the server.
Default: 120s*100 = 3.3h
So if you spawn new runners every 5 minutes via crontab cronjob setting, you get a total process count of 40 as the worse case scenario.
Via workertimeout config it can be manually adjusted to a custom value. Make sure you adjust it to the longest possible running job * x seconds at least.
The previous 0 (forever) timeout on runners is not a recommended setting anymore.
Allow filtering per type and group also with multiple values (comma separated). Allow also excluding using - prefix.
Allow filtering per type and group also with multiple values (comma separated). Allow also excluding using - prefix.
Allow runner to only fetch certain group or type.
Queue.isSearchEnabled Configure key. Otherwise auto-detect based on friendsofcake/search plugin being loaded decides this.Added Monitor example task that can also be used to quickly check the current PHP and memory setting in the (crontab) CLI environment used for the cro
Simplified using built-in Email task (content key now on same level as settings and vars key).
Fixed transport setting for QueueEmailTask
CakePHP 3.5+ from here on due to PHP 7.2 compatibility.
CakePHP 3.5+ from here on due to PHP 7.2 compatibility.
Added isQueued() convenience method for simple re-queue checking.
Added isQueued() convenience method for simple re-queue checking.
The failureMessage property has been deprecated. In the next major the tasks' run() method must be void and throw an exception with a meaningful error…
Make posix extension optional, but recommended. Also visible in admin overview now.
Make posix extension optional, but recommended. Also visible in admin overview now.
One column per quarter.