├── .coveralls.yml
├── .github
    ├── CONTRIBUTING.md
    ├── ISSUE_TEMPLATE.md
    └── PULL_REQUEST_TEMPLATE.md
├── .gitignore
├── .travis.yml
├── CHANGELOG.md
├── LICENSE
├── README.md
├── build
    └── phpunit.xml
├── composer.json
├── src
    ├── CrontabValidator.php
    └── Exceptions
    │   └── InvalidExpressionException.php
└── tests
    ├── Unit
        ├── CrontabValidatorTest.php
        └── DataProviders
        │   ├── InvalidExpressions.php
        │   └── ValidExpressions.php
    └── bootstrap.php


/.coveralls.yml:
--------------------------------------------------------------------------------
1 | service_name: travis-ci
2 | coverage_clover: build/logs/clover.xml
3 | json_path: build/logs/coveralls-upload.json
4 | 


--------------------------------------------------------------------------------
/.github/CONTRIBUTING.md:
--------------------------------------------------------------------------------
 1 | # Contributing
 2 | 
 3 | Contributions are **welcome** and will be fully **credited**.
 4 | 
 5 | We accept contributions via pull requests on [GitHub](https://github.com/hollodotme/crontab-validator).
 6 | 
 7 | 
 8 | ## Pull Requests
 9 | 
10 | - **Add tests!** - Your patch will not be accepted if it does not have tests.
11 | 
12 | - **Document any change in behaviour** - Make sure the documentation in `README.md` is kept up-to-date.
13 | 
14 | - **Consider our release cycle** - We follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.
15 | 
16 | - **Create topic branches** - Do not ask us to pull from your master branch.
17 | 
18 | - **One pull request per feature** - If you want to do more than one thing, please send multiple pull requests.
19 | 
20 | - **Send coherent history** - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
21 | 
22 | 
23 | ## Running Tests
24 | 
25 | ```bash
26 | $ vendor/bin/phpunit -c build/
27 | ```
28 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE.md:
--------------------------------------------------------------------------------
 1 | ## Expected Behavior
 2 | 
 3 | 
 4 | ## Actual Behavior
 5 | 
 6 | 
 7 | ## Steps to Reproduce the Problem
 8 | 
 9 | 1.
10 | 2.
11 | 3.
12 | 
13 | ## Specifications
14 | 
15 | - Package version:
16 | - PHP version:
17 | - Platform/OS:
18 | - Subsystem:
19 | 
20 | ## Further comments
21 | 


--------------------------------------------------------------------------------
/.github/PULL_REQUEST_TEMPLATE.md:
--------------------------------------------------------------------------------
 1 | Fixes #`<issue-number>`
 2 | 
 3 | ## Proposed Changes
 4 | 
 5 | -
 6 | -
 7 | -
 8 | 
 9 | ## Further comments
10 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | .idea
 2 | 
 3 | # vagrant
 4 | .vagrant/
 5 | vagrant
 6 | 
 7 | # composer
 8 | vendor/
 9 | composer.lock
10 | 
11 | # locally generated docs
12 | build/api/
13 | build/phpdox/
14 | build/logs/


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
 1 | language: php
 2 | 
 3 | php:
 4 |   - 7.1
 5 |   - 7.2
 6 |   - 7.3
 7 |   - 7.4snapshot
 8 | 
 9 | branches:
10 |   only:
11 |     - master
12 |     - development
13 |     - /^feature\/.+$/
14 | 
15 | before_script:
16 |  - git checkout $TRAVIS_BRANCH
17 |  - composer self-update
18 |  - mkdir -p vendor/bin
19 |  - composer install -o --prefer-dist --no-interaction
20 |  - mkdir build/logs
21 | 
22 | script:
23 |  - php vendor/bin/phpunit.phar -c build/
24 | 
25 | after_success:
26 |  - travis_retry php vendor/bin/coveralls.phar -v --exclude-no-stmt
27 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # CHANGELOG
 2 | 
 3 | All notable changes to this project will be documented in this file.
 4 | This project adheres to [Semantic Versioning](http://semver.org) and [Keep a CHANGELOG](http://keepachangelog.com).
 5 | 
 6 | ## [2.0.1] - 2017-12-12
 7 | 
 8 | ### Fixed
 9 | 
10 | * Day of month field allows expressions like "5L" - [#1]
11 | 
12 | ## [2.0.0] - 2017-12-11
13 | 
14 | ### Added
15 | 
16 | * Support for the `L` modifier in the day of month section
17 | * Support for the `W` modifier in the day of month section
18 | * Support for the `L` modifier in the day of week section
19 | * Support for the `#[1-5]` modifier in the day of week section
20 | * Support for the `?` instead of an `*` in day of month section
21 | * Support for the `?` instead of an `*` in day of week section
22 | * Support for whitespaces at the beginning and end of the expression
23 | * Stricter step value checking for each section
24 | 
25 | ### Changed
26 | 
27 | * Terminology from "crontab interval" to "crontab expression"
28 | * Renamed exception class `InvalidCrontabInterval` to `InvalidExpressionException`
29 | * Class `InvalidExpressionException` now extends `\InvalidArgumentException` instead of `\Exception`
30 | * Fixed `InvalidExpressionException`'s message to match the documentation
31 | * Renamed `CrontabValidator->isIntervalValid()` to `CrontabValidator->isExpressionValid()`
32 | * Renamed `CrontabValidator->guardIntervalIsValid()` to `CrontabValidator->guardExpressionIsValid()`
33 | * Renamed parameters and method names from "interval" to "expression"
34 | 
35 | ### Removed
36 | 
37 | * Support for PHP 7.0 (Supported versions: PHP >= 7.1)
38 | * Package base exception `CrontabValidatorException`
39 | 
40 | ## [1.0.1] - 2017-12-05
41 | 
42 | ### Fixed
43 | 
44 | * Unit test compatibility with PHPUnit 6+
45 | * Usage of alias function `join`
46 | 
47 | ## [1.0.0] - 2016-08-29
48 | 
49 | ### Added
50 | 
51 | * Interval validation in boolean and/or guarding manner
52 | 
53 | [2.0.1]: https://github.com/hollodotme/crontab-validator/compare/v2.0.0...v2.0.1
54 | [2.0.0]: https://github.com/hollodotme/crontab-validator/compare/v1.0.1...v2.0.0
55 | [1.0.1]: https://github.com/hollodotme/crontab-validator/compare/v1.0.0...v1.0.1
56 | [1.0.0]: https://github.com/hollodotme/crontab-validator/tree/v1.0.0
57 | 
58 | [#1]: https://github.com/hollodotme/crontab-validator/issues/1
59 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2016-2017 Holger Woltersdorf and contributors
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | [![Build Status](https://travis-ci.org/hollodotme/crontab-validator.svg?branch=master)](https://travis-ci.org/hollodotme/crontab-validator)
 2 | [![Coverage Status](https://coveralls.io/repos/github/hollodotme/crontab-validator/badge.svg?branch=master)](https://coveralls.io/github/hollodotme/crontab-validator?branch=master)
 3 | [![Latest Stable Version](https://poser.pugx.org/hollodotme/crontab-validator/v/stable)](https://packagist.org/packages/hollodotme/crontab-validator) 
 4 | [![Total Downloads](https://poser.pugx.org/hollodotme/crontab-validator/downloads)](https://packagist.org/packages/hollodotme/crontab-validator) 
 5 | [![License](https://poser.pugx.org/hollodotme/crontab-validator/license)](https://packagist.org/packages/hollodotme/crontab-validator)
 6 | 
 7 | # CrontabValidator
 8 | 
 9 | A validator for crontab expressions.
10 | 
11 | Sources used to determine the allowed expressions:
12 | 
13 | * https://crontab.guru/
14 | * https://en.wikipedia.org/wiki/Cron
15 | 
16 | ## Features
17 | 
18 | * Validation of crontab expressions like <kbd>6,21,36,51 7-23/1 * FEB-NOV/2 *</kbd>.
19 | 
20 | ## Requirements
21 | 
22 | * PHP >= 7.1
23 | 
24 | ## Installation
25 | 
26 | ```
27 | composer require "hollodotme/crontab-validator"
28 | ```
29 | 
30 | ## Usage
31 | 
32 | ### Boolean validation
33 | 
34 | ```php
35 | <?php declare(strict_types=1);
36 | 
37 | namespace MyVendor\MyProject;
38 | 
39 | use hollodotme\CrontabValidator\CrontabValidator;
40 | 
41 | $validator = new CrontabValidator();
42 | 
43 | if ( $validator->isExpressionValid( '6,21,36,51 7-23/1 * FEB-NOV/2 *' ) )
44 | {
45 | 	echo 'Expression is valid.';
46 | }
47 | else
48 | {
49 | 	echo 'Expression is invalid.';	
50 | }
51 | ```
52 | 
53 | ### Guarding
54 | 
55 | ```php
56 | <?php declare(strict_types=1);
57 | 
58 | namespace MyVendor\MyProject;
59 | 
60 | use hollodotme\CrontabValidator\CrontabValidator;
61 | use hollodotme\CrontabValidator\Exceptions\InvalidExpressionException;
62 | 
63 | $validator = new CrontabValidator();
64 | 
65 | try 
66 | {
67 | 	# => All fine, execution continues
68 | 	$validator->guardExpressionIsValid( '6,21,36,51 7-23/1 * FEB-NOV/2 *' );
69 | 	
70 | 	# => This will raise an InvalidExpressionException
71 | 	$validator->guardExpressionIsValid( 'this is not a valid interval' );
72 | }
73 | catch ( InvalidExpressionException $e )
74 | {
75 | 	echo $e->getMessage();
76 | }
77 | ```
78 | 
79 | **Prints:**
80 | 
81 | 	Invalid crontab expression: "this is not a valid interval"
82 | 	
83 | 
84 | ---
85 | 
86 | Feedback and contributions welcome!
87 | 


--------------------------------------------------------------------------------
/build/phpunit.xml:
--------------------------------------------------------------------------------
 1 | <phpunit
 2 | 	bootstrap="../tests/bootstrap.php"
 3 | 	verbose="true"
 4 | 	beStrictAboutOutputDuringTests="true"
 5 | 	beStrictAboutTestSize="true"
 6 | 	colors="true"
 7 | 	convertErrorsToExceptions="true"
 8 | 	convertNoticesToExceptions="true"
 9 | 	convertWarningsToExceptions="true">
10 | 	<testsuites>
11 | 		<testsuite name="CrontabValidator-Unit">
12 | 			<directory suffix="Test.php">../tests/Unit</directory>
13 | 		</testsuite>
14 | 	</testsuites>
15 | 	<filter>
16 | 		<whitelist processUncoveredFilesFromWhitelist="true">
17 | 			<directory suffix=".php">../src</directory>
18 | 		</whitelist>
19 | 		<blacklist>
20 | 			<directory suffix=".php">../tests/Unit</directory>
21 | 			<directory>../tests/Unit/Fixtures</directory>
22 | 			<directory>../vendor</directory>
23 | 		</blacklist>
24 | 	</filter>
25 | 	<logging>
26 | 		<log type="coverage-html" target="logs/coverage"/>
27 | 		<log type="coverage-clover" target="logs/clover.xml"/>
28 | 	</logging>
29 | </phpunit>
30 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 | 	"name": "hollodotme/crontab-validator",
 3 | 	"description": "A validator for crontab expressions.",
 4 | 	"minimum-stability": "dev",
 5 | 	"prefer-stable": true,
 6 | 	"license": "MIT",
 7 | 	"authors": [
 8 | 		{
 9 | 			"name": "Holger Woltersdorf (hollodotme)",
10 | 			"email": "hw@hollo.me"
11 | 		}
12 | 	],
13 | 	"support": {
14 | 		"source": "https://github.com/hollodotme/crontab-validator"
15 | 	},
16 | 	"require": {
17 | 		"php": ">=7.1"
18 | 	},
19 | 	"require-dev": {
20 | 		"tm/tooly-composer-script": "^1.0"
21 | 	},
22 | 	"autoload": {
23 | 		"psr-4": {
24 | 			"hollodotme\\CrontabValidator\\": "src/"
25 | 		}
26 | 	},
27 | 	"autoload-dev": {
28 | 		"psr-4": {
29 | 			"hollodotme\\CrontabValidator\\Tests\\": "tests/"
30 | 		}
31 | 	},
32 | 	"scripts": {
33 | 		"post-install-cmd": "Tooly\\ScriptHandler::installPharTools",
34 | 		"post-update-cmd": "Tooly\\ScriptHandler::installPharTools"
35 | 	},
36 | 	"extra": {
37 | 		"tools": {
38 | 			"phpunit": {
39 | 				"url": "https://phar.phpunit.de/phpunit-6.5.4.phar",
40 | 				"only-dev": true
41 | 			},
42 | 			"coveralls": {
43 | 				"url": "https://github.com/satooshi/php-coveralls/releases/download/v1.0.1/coveralls.phar",
44 | 				"only-dev": true
45 | 			}
46 | 		}
47 | 	}
48 | }
49 | 


--------------------------------------------------------------------------------
/src/CrontabValidator.php:
--------------------------------------------------------------------------------
 1 | <?php declare(strict_types=1);
 2 | /**
 3 |  * @author hollodotme
 4 |  */
 5 | 
 6 | namespace hollodotme\CrontabValidator;
 7 | 
 8 | use hollodotme\CrontabValidator\Exceptions\InvalidExpressionException;
 9 | 
10 | /**
11 |  * Class CrontabValidator
12 |  * @package hollodotme\CrontabValidator
13 |  */
14 | class CrontabValidator
15 | {
16 | 	/** @var string */
17 | 	private $expressionCheckRegExp;
18 | 
19 | 	public function __construct()
20 | 	{
21 | 		$this->expressionCheckRegExp = $this->buildExpressionCheckRegExp();
22 | 	}
23 | 
24 | 	/**
25 | 	 * @return string
26 | 	 */
27 | 	private function buildExpressionCheckRegExp() : string
28 | 	{
29 | 		$numbers = [
30 | 			'min'        => '[0-5]?\d',
31 | 			'hour'       => '[01]?\d|2[0-3]',
32 | 			'dayOfMonth' => '((0?[1-9]|[12]\d|3[01])W?|L|\?)',
33 | 			'month'      => '0?[1-9]|1[012]|jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec',
34 | 			'dayOfWeek'  => '([0-7]|mon|tue|wed|thu|fri|sat|sun|\?)(L|\#[1-5])?',
35 | 		];
36 | 
37 | 		$steps = [
38 | 			'min'        => '(0?[1-9]|[1-5]\d)',
39 | 			'hour'       => '(0?[1-9]|1\d|2[0-3])',
40 | 			'dayOfMonth' => '(0?[1-9]|[12]\d|3[01])',
41 | 			'month'      => '(0?[1-9]|1[012])',
42 | 			'dayOfWeek'  => '[1-7]',
43 | 		];
44 | 
45 | 		$sections = [];
46 | 		foreach ( $numbers as $section => $number )
47 | 		{
48 | 			$step                 = $steps[ $section ];
49 | 			$range                = "({$number})(-({$number})(/{$step})?)?";
50 | 			$sections[ $section ] = "\*(/{$step})?|{$number}(/{$step})?|{$range}(,{$range})*";
51 | 		}
52 | 
53 | 		$joinedSections = '(' . implode( ')\s+(', $sections ) . ')';
54 | 		$replacements   = '@reboot|@yearly|@annually|@monthly|@weekly|@daily|@midnight|@hourly';
55 | 
56 | 		return "^\s*({$joinedSections}|({$replacements}))\s*$";
57 | 	}
58 | 
59 | 	/**
60 | 	 * @param string $expression
61 | 	 *
62 | 	 * @return bool
63 | 	 */
64 | 	public function isExpressionValid( string $expression ) : bool
65 | 	{
66 | 		return (bool)preg_match( "#{$this->expressionCheckRegExp}#i", $expression );
67 | 	}
68 | 
69 | 	/**
70 | 	 * @param string $expression
71 | 	 *
72 | 	 * @throws InvalidExpressionException
73 | 	 */
74 | 	public function guardExpressionIsValid( string $expression ) : void
75 | 	{
76 | 		if ( !$this->isExpressionValid( $expression ) )
77 | 		{
78 | 			throw (new InvalidExpressionException())->withExpression( $expression );
79 | 		}
80 | 	}
81 | }
82 | 


--------------------------------------------------------------------------------
/src/Exceptions/InvalidExpressionException.php:
--------------------------------------------------------------------------------
 1 | <?php declare(strict_types=1);
 2 | /**
 3 |  * @author hollodotme
 4 |  */
 5 | 
 6 | namespace hollodotme\CrontabValidator\Exceptions;
 7 | 
 8 | /**
 9 |  * Class InvalidExpressionException
10 |  * @package hollodotme\CrontabValidator\Exceptions
11 |  */
12 | final class InvalidExpressionException extends \InvalidArgumentException
13 | {
14 | 	/** @var string */
15 | 	private $expression;
16 | 
17 | 	public function getExpression() : string
18 | 	{
19 | 		return $this->expression;
20 | 	}
21 | 
22 | 	public function withExpression( string $expression ) : InvalidExpressionException
23 | 	{
24 | 		$this->message    = sprintf( 'Invalid crontab expression: "%s"', $expression );
25 | 		$this->expression = $expression;
26 | 
27 | 		return $this;
28 | 	}
29 | }
30 | 


--------------------------------------------------------------------------------
/tests/Unit/CrontabValidatorTest.php:
--------------------------------------------------------------------------------
  1 | <?php declare(strict_types=1);
  2 | /**
  3 |  * @author hollodotme
  4 |  */
  5 | 
  6 | namespace hollodotme\CrontabValidator\Tests\Unit;
  7 | 
  8 | use hollodotme\CrontabValidator\CrontabValidator;
  9 | use hollodotme\CrontabValidator\Exceptions\InvalidExpressionException;
 10 | use PHPUnit\Framework\TestCase;
 11 | 
 12 | /**
 13 |  * Class CrontabValidatorTest
 14 |  * @package hollodotme\CrontabValidator\Tests\Unit
 15 |  */
 16 | final class CrontabValidatorTest extends TestCase
 17 | {
 18 | 	/**
 19 | 	 * @param string $expression
 20 | 	 *
 21 | 	 * @dataProvider validExpressionsProvider
 22 | 	 */
 23 | 	public function testExpressionIsValid( string $expression ) : void
 24 | 	{
 25 | 		$validator = new CrontabValidator();
 26 | 
 27 | 		$this->assertTrue( $validator->isExpressionValid( $expression ) );
 28 | 
 29 | 		$validator->guardExpressionIsValid( $expression );
 30 | 	}
 31 | 
 32 | 	public function validExpressionsProvider() : array
 33 | 	{
 34 | 		return require __DIR__ . '/DataProviders/ValidExpressions.php';
 35 | 	}
 36 | 
 37 | 	/**
 38 | 	 * @param string $expression
 39 | 	 *
 40 | 	 * @dataProvider invalidExpressionsProvider
 41 | 	 */
 42 | 	public function testExpressionIsInvalid( string $expression ) : void
 43 | 	{
 44 | 		$validator = new CrontabValidator();
 45 | 
 46 | 		$this->assertFalse( $validator->isExpressionValid( $expression ) );
 47 | 	}
 48 | 
 49 | 	public function invalidExpressionsProvider() : array
 50 | 	{
 51 | 		return require __DIR__ . '/DataProviders/InvalidExpressions.php';
 52 | 	}
 53 | 
 54 | 	/**
 55 | 	 * @param string $expression
 56 | 	 *
 57 | 	 * @dataProvider invalidExpressionsProvider
 58 | 	 */
 59 | 	public function testInvalidExpressionThrowsException( string $expression ) : void
 60 | 	{
 61 | 		try
 62 | 		{
 63 | 			(new CrontabValidator())->guardExpressionIsValid( $expression );
 64 | 		}
 65 | 		catch ( InvalidExpressionException $e )
 66 | 		{
 67 | 			$this->assertSame( 'Invalid crontab expression: "' . $expression . '"', $e->getMessage() );
 68 | 			$this->assertSame( $expression, $e->getExpression() );
 69 | 		}
 70 | 	}
 71 | 
 72 | 	public function testExpressionAllowsTheLastModifierInDayOfMonth() : void
 73 | 	{
 74 | 		$validator = new CrontabValidator();
 75 | 
 76 | 		$this->assertTrue( $validator->isExpressionValid( '* * L * *' ) );
 77 | 		$this->assertTrue( $validator->isExpressionValid( '* * 5W,L * *' ) );
 78 | 	}
 79 | 
 80 | 	public function testExpressionAllowsTheLastModifierInDayOfWeek() : void
 81 | 	{
 82 | 		$validator = new CrontabValidator();
 83 | 
 84 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 5L' ) );
 85 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * WEDL' ) );
 86 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 3L,5L' ) );
 87 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 2L-5L' ) );
 88 | 	}
 89 | 
 90 | 	public function testExpressionAllowsTheHashtagModifierInDayOfWeek() : void
 91 | 	{
 92 | 		$validator = new CrontabValidator();
 93 | 
 94 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 5#1' ) );
 95 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 4#2' ) );
 96 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 3#3' ) );
 97 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 2#4' ) );
 98 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * 1#5' ) );
 99 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * MON#5' ) );
100 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * TUE#4' ) );
101 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * WED#3' ) );
102 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * thu#2' ) );
103 | 		$this->assertTrue( $validator->isExpressionValid( '* * * * Fri#1' ) );
104 | 	}
105 | 
106 | 	public function testInvalidHashtagModifierIsNotAllowed() : void
107 | 	{
108 | 		$validator = new CrontabValidator();
109 | 
110 | 		$this->assertFalse( $validator->isExpressionValid( '* * * * 1#6' ) );
111 | 		$this->assertFalse( $validator->isExpressionValid( '* * * * Wed#0' ) );
112 | 	}
113 | 
114 | 	public function testCanUseQuestionmarkInsteadOfAsteriskForDayOfMonth() : void
115 | 	{
116 | 		$validator = new CrontabValidator();
117 | 
118 | 		$this->assertTrue( $validator->isExpressionValid( '* * ? * *' ) );
119 | 	}
120 | 
121 | 	public function testInvalidStepsAreNotAllowedInMinuteSection() : void
122 | 	{
123 | 		$validator = new CrontabValidator();
124 | 
125 | 		# Invalid minute steps
126 | 		$this->assertFalse( $validator->isExpressionValid( '*/-1 * * * *' ) );
127 | 		$this->assertFalse( $validator->isExpressionValid( '*/0 * * * *' ) );
128 | 		$this->assertFalse( $validator->isExpressionValid( '*/60 * * * *' ) );
129 | 		$this->assertFalse( $validator->isExpressionValid( '*/61 * * * *' ) );
130 | 	}
131 | 
132 | 	public function testInvalidStepsAreNotAllowedInHourSection() : void
133 | 	{
134 | 		$validator = new CrontabValidator();
135 | 
136 | 		# Invalid hour steps
137 | 		$this->assertFalse( $validator->isExpressionValid( '* */-1 * * *' ) );
138 | 		$this->assertFalse( $validator->isExpressionValid( '* */0 * * *' ) );
139 | 		$this->assertFalse( $validator->isExpressionValid( '* */24 * * *' ) );
140 | 		$this->assertFalse( $validator->isExpressionValid( '* */26 * * *' ) );
141 | 	}
142 | 
143 | 	public function testInvalidStepsAreNotAllowedInDayOfMonthSection() : void
144 | 	{
145 | 		$validator = new CrontabValidator();
146 | 
147 | 		# Invalid day of month steps
148 | 		$this->assertFalse( $validator->isExpressionValid( '* * */-1 * *' ) );
149 | 		$this->assertFalse( $validator->isExpressionValid( '* * */0 * *' ) );
150 | 		$this->assertFalse( $validator->isExpressionValid( '* * */32 * *' ) );
151 | 		$this->assertFalse( $validator->isExpressionValid( '* * */35 * *' ) );
152 | 	}
153 | 
154 | 	public function testInvalidStepsAreNotAllowedInMonthSection() : void
155 | 	{
156 | 		$validator = new CrontabValidator();
157 | 
158 | 		# Invalid month steps
159 | 		$this->assertFalse( $validator->isExpressionValid( '* * * */-1 *' ) );
160 | 		$this->assertFalse( $validator->isExpressionValid( '* * * */0 *' ) );
161 | 		$this->assertFalse( $validator->isExpressionValid( '* * * */13 *' ) );
162 | 		$this->assertFalse( $validator->isExpressionValid( '* * * */15 *' ) );
163 | 	}
164 | 
165 | 	public function testInvalidStepsAreNotAllowedInDayOfWeekSection() : void
166 | 	{
167 | 		$validator = new CrontabValidator();
168 | 
169 | 		# Invalid day of week steps
170 | 		$this->assertFalse( $validator->isExpressionValid( '* * * * */-1' ) );
171 | 		$this->assertFalse( $validator->isExpressionValid( '* * * * */0' ) );
172 | 		$this->assertFalse( $validator->isExpressionValid( '* * * * */8' ) );
173 | 		$this->assertFalse( $validator->isExpressionValid( '* * * * */10' ) );
174 | 	}
175 | }
176 | 


--------------------------------------------------------------------------------
/tests/Unit/DataProviders/InvalidExpressions.php:
--------------------------------------------------------------------------------
 1 | <?php declare(strict_types = 1);
 2 | /**
 3 |  * @author hollodotme
 4 |  */
 5 | 
 6 | return [
 7 | 	['5 7-24/1 * * *'],
 8 | 	['15 7-24/1 * * *'],
 9 | 	['8,23,38,53 7-24/1 * * *'],
10 | 	['4,19,34,49 7-24/1 * * *'],
11 | 	['6,21,36,51 7-24/1 * * *'],
12 | 	['10,25,40,55 7-24/1 * * *'],
13 | 	['11,26,41,56 7-24/1 * * *'],
14 | 	['16 7-24/1 * * *'],
15 | 	['26 7-24/1 * * *'],
16 | ];
17 | 


--------------------------------------------------------------------------------
/tests/Unit/DataProviders/ValidExpressions.php:
--------------------------------------------------------------------------------
  1 | <?php declare(strict_types = 1);
  2 | /**
  3 |  * @author hollodotme
  4 |  */
  5 | 
  6 | return [
  7 | 	['  * * * * *  '],
  8 | 	['* * * * *  '],
  9 | 	['  * * * * *'],
 10 | 	['*/10 6-19 * * 1-5'],
 11 | 	['*/15 * * * *'],
 12 | 	['0 0 * * *'],
 13 | 	['19 0 * * 1-6'],
 14 | 	['35 0 * * *'],
 15 | 	['0,30 * * * 1-5'],
 16 | 	['15,45 * * * 1-5'],
 17 | 	['30 17 * * *'],
 18 | 	['40 17 * * *'],
 19 | 	['6 3 * * *'],
 20 | 	['25,55 * * * 1-5'],
 21 | 	['18,48 * * * 1-5'],
 22 | 	['15 22 * * *'],
 23 | 	['3,33 * * * *'],
 24 | 	['6 4 * * *'],
 25 | 	['2 5 * * *'],
 26 | 	['30 7,11 * * *'],
 27 | 	['15 20 * * *'],
 28 | 	['*/10 * * * *'],
 29 | 	['30 4 * * *'],
 30 | 	['22,52 * * * *'],
 31 | 	['05 4 * * *'],
 32 | 	['4 3 * * *'],
 33 | 	['7 2 * * *'],
 34 | 	['5,35 * * * *'],
 35 | 	['46 4 * * *'],
 36 | 	['36 4 * * *'],
 37 | 	['6 5 * * *'],
 38 | 	['15 1 * * *'],
 39 | 	['1,31 0-22 * * 1-5'],
 40 | 	['15,45 0-22 * * 1-5'],
 41 | 	['0,30 0-22 * * 1-5'],
 42 | 	['5,35 0-22 * * 1-5'],
 43 | 	['59,29 7-12 * * *'],
 44 | 	['9 * * * *'],
 45 | 	['3,33 0-22 * * *'],
 46 | 	['05 19 * * *'],
 47 | 	['2 3 * * *'],
 48 | 	['24 0 * * *'],
 49 | 	['*/5 * * * *'],
 50 | 	['0 4 * * *'],
 51 | 	['0 3 * * 1-4'],
 52 | 	['23 */3 * * *'],
 53 | 	['3/15 * * * *'],
 54 | 	['3/7 * * * *'],
 55 | 	['52 6 * * *'],
 56 | 	['16 0 * * 1-6'],
 57 | 	['6 23 * * 1-5'],
 58 | 	['12 23 * * 1-5'],
 59 | 	['10 1 * * *'],
 60 | 	['21 0 * * *'],
 61 | 	['26 10 * * *'],
 62 | 	['*/15 0 * * *'],
 63 | 	['*/20 0 * * *'],
 64 | 	['25 0 * * *'],
 65 | 	['23 1 * * *'],
 66 | 	['1 4 * * *'],
 67 | 	['44 4 * * *'],
 68 | 	['29 6 * * *'],
 69 | 	['27 16 * * *'],
 70 | 	['53 1 * * *'],
 71 | 	['26,56 * * * *'],
 72 | 	['02,17,35,47 5-7,11-13 * * *'],
 73 | 	['26 12 * * *'],
 74 | 	['3 13 * * *'],
 75 | 	['4,34 * * * *'],
 76 | 	['27 15 * * *'],
 77 | 	['12 19 * * *'],
 78 | 	['48 17 * * *'],
 79 | 	['14,44 * * * *'],
 80 | 	['7 3 * * *'],
 81 | 	['30 1 * * 1-5'],
 82 | 	['1,31 2-23 * * 1-5'],
 83 | 	['1,31 8-20 * * 6-7'],
 84 | 	['5 21 * * 1-6'],
 85 | 	['10 21 * * 1-6'],
 86 | 	['59 4,10 * * 1-5'],
 87 | 	['20 1 * * *'],
 88 | 	['22 0 * * *'],
 89 | 	['7,37 * * * 1-5'],
 90 | 	['17,47 * * * 1-5'],
 91 | 	['57 4,10 * * 1-5'],
 92 | 	['7 21 * * *'],
 93 | 	['2,32 * * * *'],
 94 | 	['25 21 * * *'],
 95 | 	['44 17 * * *'],
 96 | 	['8 5 * * *'],
 97 | 	['13,43 * * * *'],
 98 | 	['05 5,12 * * *'],
 99 | 	['17 21 * * *'],
100 | 	['2 2 * * *'],
101 | 	['46 5 * * *'],
102 | 	['41 5 * * *'],
103 | 	['21 4 * * *'],
104 | 	['3 3 * * *'],
105 | 	['29 0 * * *'],
106 | 	['31 4 * * *'],
107 | 	['42 3 * * *'],
108 | 	['32 23 * * *'],
109 | 	['07 19 * * *'],
110 | 	['35 9 2 * *'],
111 | 	['7 6 * * *'],
112 | 	['34 3 * * 3'],
113 | 	['32 3 * * 3'],
114 | 	['36 3 * * 3'],
115 | 	['37 3 * * 3'],
116 | 	['33 3 * * 3'],
117 | 	['41 4 * * *'],
118 | 	['27 14 * * *'],
119 | 	['49 11 * * *'],
120 | 	['45 0 * * *'],
121 | 	['47 10 * * *'],
122 | 	['27,57 * * * *'],
123 | 	['52 5 * * *'],
124 | 	['35 18 * * *'],
125 | 	['34 6 * * *'],
126 | 	['11 4 * * *'],
127 | 	['27 4 * * *'],
128 | 	['31 6 * * *'],
129 | 	['55 23 * * *'],
130 | 	['19 15 * * *'],
131 | 	['3 15 * * *'],
132 | 	['53 23 * * *'],
133 | 	['6,36 * * * *'],
134 | 	['47 16 * * *'],
135 | 	['56 * * * *'],
136 | 	['39 * * * *'],
137 | 	['58 * * * *'],
138 | 	['58 17 * * *'],
139 | 	['47 12 * * *'],
140 | 	['49 17 * * *'],
141 | 	['8,38 * * * *'],
142 | 	['17,47 * * * *'],
143 | 	['45 22 * * *'],
144 | 	['30 0 * * *'],
145 | 	['17 0 * * 1-6'],
146 | 	['5 */1 * * *'],
147 | 	['10 23 * * *'],
148 | 	['7,37 * * * *'],
149 | 	['47 3 * * 3'],
150 | 	['33 0 * * *'],
151 | 	['34 0 * * *'],
152 | 	['31 0 * * *'],
153 | 	['32 0 * * *'],
154 | 	['27 0 * * *'],
155 | 	['28 0 * * *'],
156 | 	['26 0 * * *'],
157 | 	['13 3 * * *'],
158 | 	['51 * * * *'],
159 | 	['26 4 * * *'],
160 | 	['1 5 * * *'],
161 | 	['1,31 * * * *'],
162 | 	['53 * * * *'],
163 | 	['30 00 * * *'],
164 | 	['8,10,12,14,16,18 0 * * 1-6'],
165 | 	['43 18 * * *'],
166 | 	['*/20 * * * *'],
167 | 	['30 23 * * *'],
168 | 	['8,28 * * * *'],
169 | 	['14 3 * * *'],
170 | 	['3 1 * * 1'],
171 | 	['8 1 * * 1'],
172 | 	['22 1 * * 1'],
173 | 	['6 1 * * 1'],
174 | 	['42 1 * * 1'],
175 | 	['16 4 * * *'],
176 | 	['27 7 * * *'],
177 | 	['44 3 * * 3'],
178 | 	['32 5 * * *'],
179 | 	['33 6 * * *'],
180 | 	['54 * * * *'],
181 | 	['41 3 * * *'],
182 | 	['46 3 * * *'],
183 | 	['51 3 * * *'],
184 | 	['38 3 * * *'],
185 | 	['43 3 * * *'],
186 | 	['11 3 * * *'],
187 | 	['42 3 * * 3'],
188 | 	['9,39 * * * *'],
189 | 	['15 14 * * *'],
190 | 	['22 23 * * *'],
191 | 	['10 19 * * *'],
192 | 	['10 14 * * *'],
193 | 	['18 * * * *'],
194 | 	['8,10,12,14,16,18 23 * * 1-6'],
195 | 	['11 2 * * *'],
196 | 	['6 2 * * *'],
197 | 	['16 2 * * *'],
198 | 	['21 2 * * *'],
199 | 	['26 2 * * *'],
200 | 	['33 3 * * *'],
201 | 	['35 2 * * *'],
202 | 	['41 2 * * *'],
203 | 	['5,35 * * * 1-5'],
204 | 	['25 17 * * *'],
205 | 	['35 17 * * *'],
206 | 	['*/30 * * * *'],
207 | 	['15 15 * * *'],
208 | 	['11,41 * * * *'],
209 | 	['10 18 * * *'],
210 | 	['45,13 * * * *'],
211 | 	['15 * * * *'],
212 | 	['26 * * * *'],
213 | 	['25 16 * * *'],
214 | 	['35 16 * * *'],
215 | 	['37 * * * *'],
216 | 	['26 6 * * *'],
217 | 	['48 * * * *'],
218 | 	['52 3 * * 3'],
219 | 	['*/16 * * * *'],
220 | 	['9,11,13,15,17,19 0 * * 1-6'],
221 | 	['46 * * * *'],
222 | 	['49 * * * *'],
223 | 	['58 10 * * *'],
224 | 	['47 * * * *'],
225 | 	['16 9 * * *'],
226 | 	['0 7 * * *'],
227 | 	['6,36 * * * 1-5'],
228 | 	['11,41 * * * 1-5'],
229 | 	['25 19 * * *'],
230 | 	['35 19 * * *'],
231 | 	['10 */1 * * *'],
232 | 	['16 */1 * * *'],
233 | 	['28,58 * * * 1-5'],
234 | 	['20,22,24,26,28 0 * * 1-6'],
235 | 	['*/10 6-19 * * *'],
236 | 	['41 20 * * *'],
237 | 	['12,42 * * * *'],
238 | 	['8 * * * *'],
239 | 	['22 6 * * *'],
240 | 	['20 18 * * *'],
241 | 	['*/7 * * * *'],
242 | 	['28 03 * * *'],
243 | 	['33 18 * * 7'],
244 | 	['38 18 * * 7'],
245 | 	['28 22 * * *'],
246 | 	['17 1 * * *'],
247 | 	['33 20 * * *'],
248 | 	['10 6 * * *'],
249 | 	['10 7 * * *'],
250 | 	['23 * * * *'],
251 | 	['24 * * * *'],
252 | 	['28 */1 * * *'],
253 | 	['5 7 * * *'],
254 | 	['18 3 * * *'],
255 | 	['41 3 * * 3'],
256 | 	['38 3 * * 3'],
257 | 	['9 3 * * *'],
258 | 	['12 3 * * *'],
259 | 	['43 3 * * 3'],
260 | 	['*/10 * * * 1-5'],
261 | 	['41 9 * * *'],
262 | 	['36 3 * * *'],
263 | 	['18 0 * * 1-6'],
264 | 	['48 5 * * *'],
265 | 	['7 5 * * *'],
266 | 	['4 9 * * *'],
267 | 	['16 3 * * *'],
268 | 	['17 3 * * *'],
269 | 	['48 3 * * 3'],
270 | 	['56 3 * * 3'],
271 | 	['0 1 * * *'],
272 | 	['21 0 * * 1-6'],
273 | 	['13 1 * * *'],
274 | 	['11 6 * * *'],
275 | 	['16,46 * * * *'],
276 | 	['26 16 * * *'],
277 | 	['6 17 * * *'],
278 | 	['17,49 * * * *'],
279 | 	['33 7 * * *'],
280 | 	['14 3,9,14,22 * * *'],
281 | 	['15 16 * * *'],
282 | 	['25 13 * * *'],
283 | 	['35 13 * * *'],
284 | 	['18 5 * * *'],
285 | 	['58 4 * * *'],
286 | 	['16 16 * * *'],
287 | 	['20,50 * * * *'],
288 | 	['19 12 * * *'],
289 | 	['23 18 * * *'],
290 | 	['30,01 * * * *'],
291 | 	['34 * * * *'],
292 | 	['18,48 * * * *'],
293 | 	['4 15 * * *'],
294 | 	['10 3 * * *'],
295 | 	['39 3 * * 3'],
296 | 	['2,6,8,12,16 0 * * 1-6'],
297 | 	['37 10 * * *'],
298 | 	['07 14 * * *'],
299 | 	['36 18 * * *'],
300 | 	['54 17 * * *'],
301 | 	['*/2 * * * *'],
302 | 	['29 20 * * *'],
303 | 	['28 3 * * 3'],
304 | 	['51 15 * * *'],
305 | 	['31 20 * * *'],
306 | 	['13 19 * * *'],
307 | 	['18 19 * * *'],
308 | 	['23 19 * * *'],
309 | 	['29 18 * * *'],
310 | 	['26 18 * * *'],
311 | 	['39 18 * * *'],
312 | 	['32 18 * * *'],
313 | 	['28 10 * * *'],
314 | 	['46 */1 * * *'],
315 | 	['11 * * * *'],
316 | 	['13 * * * *'],
317 | 	['14 * * * *'],
318 | 	['33 * * * *'],
319 | 	['28 * * * *'],
320 | 	['37 3 * * *'],
321 | 	['5 7-23/1 * * *'],
322 | 	['15 7-23/1 * * *'],
323 | 	['25 7 * * *'],
324 | 	['35 7 * * *'],
325 | 	['8,23,38,53 7-23/1 * JAN *'],
326 | 	['4,19,34,49 7-23/1 * dec *'],
327 | 	['6,21,36,51 7-23/1 * FEB-NOV/2 *'],
328 | 	['6 9 * * *'],
329 | 	['11 9 * * *'],
330 | 	['10,25,40,55 7-23/1 * * *'],
331 | 	['11,26,41,56 7-23/1 * * *'],
332 | 	['40 18 * * *'],
333 | 	['50 18 * * *'],
334 | 	['39 3 * * *'],
335 | 	['6 * * * *'],
336 | 	['47 22 * * *'],
337 | 	['50 * * * *'],
338 | 	['40 * * * *'],
339 | 	['5 */2 * * *'],
340 | 	['22 7,19 * * 1-5'],
341 | 	['22 2,8,14,20 * * 1-5'],
342 | 	['35 6 * * *'],
343 | 	['16 7-23/1 * * *'],
344 | 	['26 7-23/1 * * *'],
345 | 	['25 9 * * *'],
346 | 	['29 9 * * *'],
347 | 	['05 11 * * *'],
348 | 	['12 8 * * *'],
349 | 	['25 19 * * 1-5'],
350 | 	['35 19 * * 1-5'],
351 | 	['28,58 0-22 * * 1-5'],
352 | 	['6,36 0-22 * * 1-5'],
353 | 	['*/10 6-20 * * 1-5'],
354 | 	['14 22 * * *'],
355 | 	['30 5 * * *'],
356 | 	['23 0 * * 1-6'],
357 | 	['1 0 1 * *'],
358 | 	['11 0 1 * *'],
359 | 	['02 21 * * *'],
360 | 	['12 6 * * *'],
361 | 	['05,25 04 * * *'],
362 | 	['45 3 * * *'],
363 | 	['3 9,15 * * 1-5'],
364 | 	['7,17 9,15 * * mon-fri'],
365 | 	['26 0 * * 1-6'],
366 | 	['*/1 * * * *'],
367 | 	['2,32 0-21,23 * * *'],
368 | 	['*/10 21-22 * * *'],
369 | 	['24 6 * * *'],
370 | 	['5 23 * * *'],
371 | 	['3 5 * * *'],
372 | 	['50 21 * * *'],
373 | 	['0 22 * * *'],
374 | 	['6 22 * * *'],
375 | 	['*/15 20 * * *'],
376 | 	['00 16 * * *'],
377 | 	['0 2 * * *'],
378 | 	['*/10 6-20 * * *'],
379 | 	['5 22 * * *'],
380 | 	['50 3 * * *'],
381 | 	['48 3 * * *'],
382 | 	['46 3 * * 3'],
383 | 	['27 20 * * 1-5'],
384 | 	['37 20 * * 1-5'],
385 | 	['36 4 * * 0'],
386 | 	['45 3 * * 3'],
387 | 	['49 3 * * 3'],
388 | 	['51 3 * * 3'],
389 | 	['53 3 * * 3'],
390 | 	['57 3 * * *'],
391 | 	['27 07 * * *'],
392 | 	['*/10 2-22 * * *'],
393 | 	['03 06 * * *'],
394 | 	['25 22 * * 1-5'],
395 | 	['57 23 * * 1-5'],
396 | 	['*/15 2-22 * * *'],
397 | 	['25 20 * * *'],
398 | 	['13 20 * * *'],
399 | 	['7 */1 * * *'],
400 | 	['*/8 * * * *'],
401 | 	['0 23 * * *'],
402 | 	['*/21 * * * *'],
403 | 	['0 6 * * *'],
404 | 	['*/35 * * * *'],
405 | 	['*/25 * * * *'],
406 | 	['57,27 8-15 * * *'],
407 | 	['0 20 * * *'],
408 | 	['37 6 * * *'],
409 | 	['14 6 * * *'],
410 | 	['30 * * * *'],
411 | 	['31 * * * *'],
412 | 	['27,57 8-15 * * *'],
413 | 	['7,37 8-15 * * *'],
414 | 	['1 */1 * * *'],
415 | 	['30 20 * * *'],
416 | 	['1 21 * * *'],
417 | 	['25 3 * * *'],
418 | 	['30 3 * * *'],
419 | 	['35 3 * * 3'],
420 | 	[ '2,17,35,47 5-7,11-13 * * *' ],
421 | 	['@annually'],
422 | 	['@monthly'],
423 | 	['@daily'],
424 | 	['@reboot'],
425 | 	['@yearly'],
426 | 	['@midnight'],
427 | 	['@hourly'],
428 | ];
429 | 


--------------------------------------------------------------------------------
/tests/bootstrap.php:
--------------------------------------------------------------------------------
1 | <?php declare(strict_types = 1);
2 | /**
3 |  * @author hollodotme
4 |  */
5 | 
6 | require __DIR__ . '/../vendor/autoload.php';
7 | 


--------------------------------------------------------------------------------