hollodotme/crontab-validator

A validator for crontab expressions.

Maintainers

Details

github.com/hollodotme/crontab-validator

Source

Issues

Installs: 122 594

Dependents: 2

Suggesters: 0

Security: 0

Stars: 10

Watchers: 3

Forks: 4

Open Issues: 1

v2.0.1 2017-12-12 10:33 UTC

Requires

  • php: >=7.1

Requires (Dev)

MIT 44f6cab51ed3b445c69caaf7cc8f2d413a9ccf60

  • Holger Woltersdorf (hollodotme) <hw.woop@hollo.me>

This package is auto-updated.

Last update: 2024-11-05 08:09:48 UTC

README

Build Status Coverage Status Latest Stable Version Total Downloads License

CrontabValidator

A validator for crontab expressions.

Sources used to determine the allowed expressions:

Features

  • Validation of crontab expressions like 6,21,36,51 7-23/1 * FEB-NOV/2 *.

Requirements

  • PHP >= 7.1

Installation

composer require "hollodotme/crontab-validator"

Usage

Boolean validation

<?php declare(strict_types=1);

namespace MyVendor\MyProject;

use hollodotme\CrontabValidator\CrontabValidator;

$validator = new CrontabValidator();

if ( $validator->isExpressionValid( '6,21,36,51 7-23/1 * FEB-NOV/2 *' ) )
{
	echo 'Expression is valid.';
}
else
{
	echo 'Expression is invalid.';	
}

Guarding

<?php declare(strict_types=1);

namespace MyVendor\MyProject;

use hollodotme\CrontabValidator\CrontabValidator;
use hollodotme\CrontabValidator\Exceptions\InvalidExpressionException;

$validator = new CrontabValidator();

try 
{
	# => All fine, execution continues
	$validator->guardExpressionIsValid( '6,21,36,51 7-23/1 * FEB-NOV/2 *' );
	
	# => This will raise an InvalidExpressionException
	$validator->guardExpressionIsValid( 'this is not a valid interval' );
}
catch ( InvalidExpressionException $e )
{
	echo $e->getMessage();
}

Prints:

Invalid crontab expression: "this is not a valid interval"

Feedback and contributions welcome!