{"id":13684231,"url":"https://github.com/dereuromark/cakephp-queue","last_synced_at":"2025-04-14T20:51:30.770Z","repository":{"id":37768288,"uuid":"2543495","full_name":"dereuromark/cakephp-queue","owner":"dereuromark","description":"Queue plugin for CakePHP - simple, pure PHP and without dependencies.","archived":false,"fork":false,"pushed_at":"2025-03-21T12:09:25.000Z","size":1993,"stargazers_count":306,"open_issues_count":2,"forks_count":137,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-04-09T20:02:01.358Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dereuromark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-10-09T17:09:44.000Z","updated_at":"2025-03-19T02:05:29.000Z","dependencies_parsed_at":"2023-12-21T15:35:34.659Z","dependency_job_id":"9413d0d7-5a69-4277-bdc4-e3bae0897fb9","html_url":"https://github.com/dereuromark/cakephp-queue","commit_stats":{"total_commits":929,"total_committers":70,"mean_commits":"13.271428571428572","dds":0.5543595263724435,"last_synced_commit":"26014bfaa211fd34a5f3cdff434a00b311cb1932"},"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fcakephp-queue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fcakephp-queue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fcakephp-queue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fcakephp-queue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dereuromark","download_url":"https://codeload.github.com/dereuromark/cakephp-queue/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248351380,"owners_count":21089270,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T14:00:31.262Z","updated_at":"2025-04-14T20:51:30.746Z","avatar_url":"https://github.com/dereuromark.png","language":"PHP","funding_links":[],"categories":["Queue","Plugins"],"sub_categories":["Email"],"readme":"# CakePHP Queue Plugin\n[![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)\n[![Coverage Status](https://img.shields.io/codecov/c/github/dereuromark/cakephp-queue/master.svg)](https://codecov.io/github/dereuromark/cakephp-queue/branch/master)\n[![Latest Stable Version](https://poser.pugx.org/dereuromark/cakephp-queue/v/stable.svg)](https://packagist.org/packages/dereuromark/cakephp-queue)\n[![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%208.1-8892BF.svg)](https://php.net/)\n[![PHPStan](https://img.shields.io/badge/PHPStan-level%208-brightgreen.svg?style=flat)](https://phpstan.org/)\n[![License](https://poser.pugx.org/dereuromark/cakephp-queue/license.svg)](LICENSE)\n[![Total Downloads](https://poser.pugx.org/dereuromark/cakephp-queue/d/total)](https://packagist.org/packages/dereuromark/cakephp-queue)\n[![Coding Standards](https://img.shields.io/badge/cs-PSR--2--R-yellow.svg)](https://github.com/php-fig-rectified/fig-rectified-standards)\n\nThis branch is for use with **CakePHP 5.0+**. For details see [version map](https://github.com/dereuromark/cakephp-queue/wiki#cakephp-version-map).\n\n\n## Background\n\nThis is a very simple and minimalistic job queue (or deferred-task) system for CakePHP.\nIf you need a very basic PHP internal queue tool, this is definitely an option.\nIt is also a great tool for demo purposes on how queues work and doesn't have any dependencies.\n\nOverall functionality is inspired by systems like Gearman, Beanstalk or dropr, but without\nany illusion to compete with these more advanced Systems.\n\nThe plugin is an attempt to provide a basic, simple to use method to enable deferred job execution,\nwithout the hassle of setting up or running an extra queue daemon, while integrating nicely into\nCakePHP and also simplifying the creation of worker scripts. You can also easily provide progress and status information into your pages.\n\nPlease 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].\nFor more high-volume and sophisticated use cases please see the [awesome list](https://github.com/FriendsOfCake/awesome-cakephp#queue) alternatives.\n\n### Why use deferred execution?\n\nDeferred execution makes sense (especially in PHP) when your page wants to execute tasks, which are not directly related to rendering the current page.\nFor instance, in a BBS-type system, a new users post might require the creation of multiple personalized email messages,\nnotifying other users of the new content.\nCreating and sending these emails is completely irrelevant to the currently active user, and should not increase page response time.\nAnother example would be downloading, extraction and/or analyzing an external file per request of the user.\nThe regular solution to these problems would be to create specialized cronjobs which use specific database states to determine which action should be done.\n\nThe Queue plugin provides a simple method to create and run such non-user-interaction-critical tasks.\n\nAnother important reason is that specific jobs can be (auto)retried if they failed.\nSo 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.\n\nWhile 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.\n\n## Demo\nSee [Sandbox app](https://sandbox.dereuromark.de/sandbox/queue-examples).\n\n## Installation and Usage\nSee [Documentation](docs/).\n\n## Cronjob based background scheduling\nIf you are looking for scheduling certain background jobs: This plugin works flawlessly with [QueueScheduler plugin](https://github.com/dereuromark/cakephp-queue-scheduler).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdereuromark%2Fcakephp-queue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdereuromark%2Fcakephp-queue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdereuromark%2Fcakephp-queue/lists"}