https://github.com/dereuromark/cakephp-queue-scheduler

CakePHP Addon for Queue plugin to schedule commands and queue tasks as crontab like DB solution
https://github.com/dereuromark/cakephp-queue-scheduler

Last synced: 3 months ago
JSON representation

CakePHP Addon for Queue plugin to schedule commands and queue tasks as crontab like DB solution

• Host: GitHub
• URL: https://github.com/dereuromark/cakephp-queue-scheduler
• Owner: dereuromark
• License: mit
• Created: 2023-10-18T00:48:03.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-03-29T23:38:52.000Z (3 months ago)
• Last Synced: 2024-03-30T17:49:12.395Z (3 months ago)
• Language: PHP
• Size: 64.5 KB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-cakephp - QueueScheduler plugin - A dependency-free crontab-like scheduler as DB driven solution and addon to Queue plugin. (Queue)

README

        
# CakePHP QueueScheduler plugin

[![CI](https://github.com/dereuromark/cakephp-queue-scheduler/actions/workflows/ci.yml/badge.svg)](https://github.com/dereuromark/cakephp-queue-scheduler/actions/workflows/ci.yml)

[![Coverage Status](https://img.shields.io/codecov/c/github/dereuromark/cakephp-queue-scheduler/master.svg)](https://codecov.io/github/dereuromark/cakephp-queue-scheduler/branch/master)

[![Latest Stable Version](https://poser.pugx.org/dereuromark/cakephp-queue-scheduler/v/stable.svg)](https://packagist.org/packages/dereuromark/cakephp-queue-scheduler)

[![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%207.4-8892BF.svg)](https://php.net/)

[![PHPStan](https://img.shields.io/badge/PHPStan-level%208-brightgreen.svg?style=flat)](https://phpstan.org/)

[![License](https://poser.pugx.org/dereuromark/cakephp-queue-scheduler/license.svg)](LICENSE)

[![Total Downloads](https://poser.pugx.org/dereuromark/cakephp-queue-scheduler/d/total)](https://packagist.org/packages/dereuromark/cakephp-queue-scheduler)

[![Coding Standards](https://img.shields.io/badge/cs-PSR--2--R-yellow.svg)](https://github.com/php-fig-rectified/fig-rectified-standards)

A scheduler addon for [Queue plugin](https://github.com/dereuromark/cakephp-queue).

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

## Motivation

A DB and queue based cronjob system does not require a sys-admin to manually modify the crontab file on a server.

It also allows for easier multi-server (worker) environments.

Such a system provides easier input and "frequency" validation, as well as visual output of the schedule in the backend.

For smaller projects it can also be ported more easily between systems (e.g. dev/stage/prod) using migrations

instead of having to touch the server config.

Also logging and i18n customization can potentially be easier to get addressed this way.

Finally, with the Queue plugin integrating it can smoothly work alongside your existing Queue tasks.

Any failed job (e.g. network issue, or email SMTP issue) can be automatically re-run x times as per config.

Further features:

- Concurrency handling: Decision in case a job is still running or failed in queue, if it will run now ones or just skip.

- The backend can provide buttons to also "trigger" any scheduled job manually where needed.

- Autocomplete or proposals based on available Cake commands or Queue tasks.

## Installation

You can install this plugin into your CakePHP application using [composer](https://getcomposer.org).

```

composer require dereuromark/cakephp-queue-scheduler

```

## Installation and Usage

See [Documentation](docs/).

## Credit where credit is due

This plugin is heavily inspired by [LordSimal Scheduler plugin](https://github.com/LordSimal/cakephp-scheduler)

and [Laravel Task Scheduling Feature](https://laravel.com/docs/10.x/scheduling).

Use this Scheduler plugin if you prefer configuring them file-based and purely in crontab style.