Download the PHP package makinacorpus/cron without Composer

Applicative cron task runner

Simple applicative cron task implementation.

How it works:

• You as the library user register callables as being cron tasks, using a descriptive attribute.

• It can be any callable, a function, an anonymous function, an instance method, a class static method or an invokable class instance.

• You need to setup a system cron entry for running the applicative cron, depending upon your framework, using Symfony a CLI command is provided. This tick must run very often, such as every minute.

• When the cron runs, for each registered task, it checks its schedule againsts the current sytem date.

• For each matching schedule, it checks first for the configured minimum delay between two run and excludes tasks which have been run too recently.

• For each remaining non excluded task, it runs it, and store the latest run data long error message and error trace if any error occured.

Simply put, it takes a task list, test each task schedule against current date, and run it when it matches.

State is per default kept in memory during runtime, then discarded. Future implementations will allow you to store it within PDO and maybe other backends.

State when persisted allows the user to change task schedule without changing the code. Schedule is always stored as a raw string which allows alternative implementations to exist.

Default schedule implementation accepts incomplete POSIX cron expression but only with single digit values. An alternative implementation can use dragonmantank/cron-expression for a more complete POSIX cron expression.

Roadmap

• [x] makinacorpus/goat-query state store implementation,
• [ ] PDO state store implementation,
• [x] unit test Symfony integration,
• [ ] logging using psr/log everything everywhere,
• [x] add scheduler implementation using dragonmantank/cron-expression,
• [ ] cron task list and detailed information restitution command,
• [ ] meaningful information display via console commands.

How to use

First, install it:

Then proceed with one of the following.

Standalone

Configuring cron tasks

First, create some cron methods:

Then create a task registry:

Running it

Then, create a runner and execute it, this is basically the piece of code you need to have in your CLI script that executes the cron:

And that's it.

Per default, schedule is forgiving, you may run this script only every 2 or 3 minutes, cron rules will match in a 5 minutes time span after their due date to avoid missing running them.

Symfony

Installing

Start by adding the bundle to the config/bundles.php file:

Configuring cron tasks

Create some services that have cron task methods, it can litteraly be any class or service, the only requirement is to set the CronTask attribute over the targeted methods:

Using the makinacorpus/argument-resolver dependency, considering you installed and configured the provided bundle, your methods can have other services as parameters, they will be injected at runtimme.

Make sure they are services in config/services.yaml or via any other service registration method:

And that's it.

Usage

Configuring schedule implementation

Default implementation

Default implementation if configuration is left untouched supports incomplete POSIX cron expressions, where parts can only be single digits.

For a lot of applications, this is more than enough.

You don't need to configure anything since this is the default.

dragonmantank/cron-expression

First install it:

Then, during your application bootstrap, call:

And use this API as you would normally do.

Commands

Commands are available when using it as a Symfony bundle, but nothing prevents you from setting up and using those outside of the Symfony full stack framework usage.

Run all cron tasks (that should run every minute)

Set this in your system cron, or supervisord, or any other orchestrator application:

You can run it manually as well:

Force run a single cron task

Simply call the same command, adding the cron task identifier as first argument:

Task configuration

Set a minimum interval

Write me.

Running tests

Core tests

Simply run PHPUnit:

Database related tests will be skipped due to the lack of configuration.

Database related tests

This uses docker compose for spawning a database environement:

This is experimental, it should work.