PHPackages                             dereuromark/cakephp-queue - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues &amp; Workers](/categories/queues)
4. /
5. dereuromark/cakephp-queue

ActiveCakephp-plugin[Queues &amp; Workers](/categories/queues)

dereuromark/cakephp-queue
=========================

The Queue plugin for CakePHP provides deferred task execution.

8.9.1(2mo ago)308850.3k—8.5%138[1 issues](https://github.com/dereuromark/cakephp-queue/issues)[1 PRs](https://github.com/dereuromark/cakephp-queue/pulls)12MITPHPPHP &gt;=8.2

Since Dec 12Pushed 1mo ago19 watchersCompare

[ Source](https://github.com/dereuromark/cakephp-queue)[ Packagist](https://packagist.org/packages/dereuromark/cakephp-queue)[ Docs](https://github.com/dereuromark/cakephp-queue)[ RSS](/packages/dereuromark-cakephp-queue/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (24)Versions (141)Used By (12)

CakePHP Queue Plugin
====================

[](#cakephp-queue-plugin)

[![CI](https://github.com/dereuromark/cakephp-queue/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/dereuromark/cakephp-queue/actions/workflows/ci.yml?query=branch%3Amaster)[![Coverage Status](https://camo.githubusercontent.com/1e7471b9f3e647f9f0a539485ecc9c30980488602a32a578aa4bf53b9cc5e760/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f6465726575726f6d61726b2f63616b657068702d71756575652f6d61737465722e737667)](https://codecov.io/github/dereuromark/cakephp-queue/branch/master)[![Latest Stable Version](https://camo.githubusercontent.com/40e17c79eb7f4ac6b9b32081526578c21bc6f91120708db3b1da854de93fd650/68747470733a2f2f706f7365722e707567782e6f72672f6465726575726f6d61726b2f63616b657068702d71756575652f762f737461626c652e737667)](https://packagist.org/packages/dereuromark/cakephp-queue)[![Minimum PHP Version](https://camo.githubusercontent.com/ec21f169d70b69344c67d6f18fa1a24d20476d2f0cd680e8c4a1534c22f34e5f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230382e322d3838393242462e737667)](https://php.net/)[![PHPStan](https://camo.githubusercontent.com/f60d96f7c2579690ab6dfa8918f777fe93a02a92301c661eb38a85861a92b780/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e2e7376673f7374796c653d666c6174)](https://phpstan.org/)[![License](https://camo.githubusercontent.com/cbeca80185c027bc71d805af150628d518efc4ffe72bb70bf98a4f563e6b0c1e/68747470733a2f2f706f7365722e707567782e6f72672f6465726575726f6d61726b2f63616b657068702d71756575652f6c6963656e73652e737667)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/ce40ff1de8ecc6c6b99cc8019184672ff707ad4487c731eb6496c8f23bdee37e/68747470733a2f2f706f7365722e707567782e6f72672f6465726575726f6d61726b2f63616b657068702d71756575652f642f746f74616c)](https://packagist.org/packages/dereuromark/cakephp-queue)[![Coding Standards](https://camo.githubusercontent.com/dbabe22710e675cb88cd0b12196f1477e2376dea497332775692cf1359a75918/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f63732d5053522d2d322d2d522d79656c6c6f772e737667)](https://github.com/php-fig-rectified/fig-rectified-standards)

This branch is for use with **CakePHP 5.1+**. For details see [version map](https://github.com/dereuromark/cakephp-queue/wiki#cakephp-version-map).

Background
----------

[](#background)

This is a very simple and minimalistic job queue (or deferred-task) system for CakePHP. If you need a very basic PHP internal queue tool, this is definitely an option. It is also a great tool for demo purposes on how queues work and doesn't have any dependencies.

Overall functionality is inspired by systems like Gearman, Beanstalk or dropr, but without any illusion to compete with these more advanced Systems.

The plugin is an attempt to provide a basic, simple to use method to enable deferred job execution, without the hassle of setting up or running an extra queue daemon, while integrating nicely into CakePHP and also simplifying the creation of worker scripts. You can also easily provide progress and status information into your pages.

Please also read my blog posts about [deferred execution](https://www.dereuromark.de/2013/12/22/queue-deferred-execution-in-cakephp/) and [real-life example usage](https://www.dereuromark.de/2021/07/15/cakephp-queuing-real-life-examples/) \[new\]. For more high-volume and sophisticated use cases please see the [awesome list](https://github.com/FriendsOfCake/awesome-cakephp#queue) alternatives.

### Why use deferred execution?

[](#why-use-deferred-execution)

Deferred execution makes sense (especially in PHP) when your page wants to execute tasks, which are not directly related to rendering the current page. For instance, in a BBS-type system, a new users post might require the creation of multiple personalized email messages, notifying other users of the new content. Creating and sending these emails is completely irrelevant to the currently active user, and should not increase page response time. Another example would be downloading, extraction and/or analyzing an external file per request of the user. The regular solution to these problems would be to create specialized cronjobs which use specific database states to determine which action should be done.

The Queue plugin provides a simple method to create and run such non-user-interaction-critical tasks.

Another important reason is that specific jobs can be (auto)retried if they failed. So if the email server didn't work the first time, or the API gateway had an issue, the current job to be executed isn't lost but kept for rerun. Most of those external services should be treated as failable once every x calls, and as such a queue implementation can help reducing issues due to such failures. If a job still can't finish despite retries, you still have the option to debug its payload and why this job cannot complete. No data is lost here.

While you can run multiple workers, and can (to some extent) spread these workers to different machines via a shared database, you should consider using a more advanced system for high volume/high number of workers systems.

Demo
----

[](#demo)

See [Sandbox app](https://sandbox.dereuromark.de/sandbox/queue-examples).

Installation and Usage
----------------------

[](#installation-and-usage)

See [Documentation](docs/).

Cronjob based background scheduling
-----------------------------------

[](#cronjob-based-background-scheduling)

If you are looking for scheduling certain background jobs: This plugin works flawlessly with [QueueScheduler plugin](https://github.com/dereuromark/cakephp-queue-scheduler).

###  Health Score

74

—

ExcellentBetter than 100% of packages

Maintenance89

Actively maintained with recent releases

Popularity59

Moderate usage in the ecosystem

Community42

Growing community involvement

Maturity93

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 79.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~32 days

Recently: every ~22 days

Total

127

Last Release

62d ago

Major Versions

6.9.1 → 7.1.22023-12-11

7.2.2 → 8.0.0-RC2024-03-07

7.2.3 → 8.0.02024-03-11

6.9.2 → 8.3.02025-06-12

6.9.3 → 8.5.12025-10-30

PHP version history (10 changes)2.0.0PHP &gt;=5.3.0

2.2.0PHP &gt;=5.4.0

3.0.0PHP &gt;=5.4.16

3.4.0PHP &gt;=5.5

3.5.0PHP &gt;=5.6

5.0.0-betaPHP &gt;=7.2

6.2.0PHP &gt;=7.3

6.4.0PHP &gt;=7.4

7.0.0-RCPHP &gt;=8.1

8.9.0PHP &gt;=8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/39854?v=4)[Mark Scherer](/maintainers/dereuromark)[@dereuromark](https://github.com/dereuromark)

---

Top Contributors

[![dereuromark](https://avatars.githubusercontent.com/u/39854?v=4)](https://github.com/dereuromark "dereuromark (861 commits)")[![LordSimal](https://avatars.githubusercontent.com/u/9105243?v=4)](https://github.com/LordSimal "LordSimal (46 commits)")[![MSeven](https://avatars.githubusercontent.com/u/31497?v=4)](https://github.com/MSeven "MSeven (37 commits)")[![inoas](https://avatars.githubusercontent.com/u/20972207?v=4)](https://github.com/inoas "inoas (17 commits)")[![houseoftech](https://avatars.githubusercontent.com/u/297458?v=4)](https://github.com/houseoftech "houseoftech (14 commits)")[![Graziel](https://avatars.githubusercontent.com/u/5963584?v=4)](https://github.com/Graziel "Graziel (12 commits)")[![jiru](https://avatars.githubusercontent.com/u/5107734?v=4)](https://github.com/jiru "jiru (11 commits)")[![stmeyer](https://avatars.githubusercontent.com/u/10654545?v=4)](https://github.com/stmeyer "stmeyer (9 commits)")[![challgren](https://avatars.githubusercontent.com/u/88909?v=4)](https://github.com/challgren "challgren (9 commits)")[![netstyler](https://avatars.githubusercontent.com/u/319755?v=4)](https://github.com/netstyler "netstyler (8 commits)")[![drmonkeyninja](https://avatars.githubusercontent.com/u/357623?v=4)](https://github.com/drmonkeyninja "drmonkeyninja (8 commits)")[![TeckniX](https://avatars.githubusercontent.com/u/33699?v=4)](https://github.com/TeckniX "TeckniX (4 commits)")[![charukiewicz](https://avatars.githubusercontent.com/u/6189390?v=4)](https://github.com/charukiewicz "charukiewicz (4 commits)")[![garas](https://avatars.githubusercontent.com/u/2265694?v=4)](https://github.com/garas "garas (4 commits)")[![mfrascati](https://avatars.githubusercontent.com/u/2734747?v=4)](https://github.com/mfrascati "mfrascati (4 commits)")[![mstroink](https://avatars.githubusercontent.com/u/2270573?v=4)](https://github.com/mstroink "mstroink (3 commits)")[![JacobAGTyler](https://avatars.githubusercontent.com/u/3827053?v=4)](https://github.com/JacobAGTyler "JacobAGTyler (3 commits)")[![lucatrev](https://avatars.githubusercontent.com/u/77144?v=4)](https://github.com/lucatrev "lucatrev (3 commits)")[![repher](https://avatars.githubusercontent.com/u/2478563?v=4)](https://github.com/repher "repher (3 commits)")[![kburton-dev](https://avatars.githubusercontent.com/u/10101978?v=4)](https://github.com/kburton-dev "kburton-dev (3 commits)")

---

Tags

asynccakephpqueuebackgroundjobsadmin-paneldeferred tasksworkers

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/dereuromark-cakephp-queue/health.svg)

```
[![Health](https://phpackages.com/badges/dereuromark-cakephp-queue/health.svg)](https://phpackages.com/packages/dereuromark-cakephp-queue)
```

###  Alternatives

[croustibat/filament-jobs-monitor

Background Jobs monitoring like Horizon for all drivers for FilamentPHP

254255.2k6](/packages/croustibat-filament-jobs-monitor)[clue/mq-react

Mini Queue, the lightweight in-memory message queue to concurrently do many (but not too many) things at once, built on top of ReactPHP

144691.7k4](/packages/clue-mq-react)[cvo-technologies/cakephp-gearman

A gearman plugin for CakePHP 3

1243.5k](/packages/cvo-technologies-cakephp-gearman)[lorenzo/cakephp-sqs

CakePHP Aws Simple Queue System

19302.4k](/packages/lorenzo-cakephp-sqs)[dereuromark/cakephp-file-storage

This plugin is giving you the possibility to store files in virtually any kind of storage backend. This plugin is wrapping the Gaufrette library (https://github.com/KnpLabs/Gaufrette) library in a CakePHP fashion and provides a simple way to use the storage adapters through the StorageManager class.

104.1k](/packages/dereuromark-cakephp-file-storage)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
