README

The PHP Cron Library can be used to get human readable cron expression description and detailed validation messages. Any level of expression complexity is handled.

Code examples

Human readable cron expression description example:

$expression = \Sivaschenko\Utility\Cron\ExpressionFactory::getExpression('5 4 8 * *');

echo $expression->getVerbalString(); // "At 04:05, on 8th day of month."

Cron expression validation example:

$expression = \Sivaschenko\Utility\Cron\ExpressionFactory::getExpression('60 * * * 2- *');

if (!$expression->isValid()) {
    print_r($expression->getValidationMessages());
}

/*
Array
(
    [0] => Minute expression part value "60" is greater than max allowed "59"
    [1] => Missing second part of "range" expression ("2-")
)
*/

Functionality examples

Examples of expression translation to verbal format:

Examples of cron expression validation:

Installation

Add dependency on library to composer.json and update or execute the following command:

composer require sivaschenko/utility-cron

Be sure to require composer generated autoload in your project:

require 'vendor/autoload.php';

Now see "Code examples" for usage instructions.

Test Coverage

Verbal translation, validation and even exceptions are covered with integration tests.

See \Sivaschenko\Utility\Cron\Test\ExpressionTest for details.

Crafted with ♥ for developers.