You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
71 lines
2.6 KiB
71 lines
2.6 KiB
9 months ago
|
PHP Cron Expression Parser
|
||
|
|
==========================
|
||
|
|
|
||
|
|
[](https://packagist.org/packages/mtdowling/cron-expression) [](https://packagist.org/packages/mtdowling/cron-expression) [](http://travis-ci.org/mtdowling/cron-expression)
|
||
|
|
|
||
|
|
The PHP cron expression parser can parse a CRON expression, determine if it is
|
||
|
|
due to run, calculate the next run date of the expression, and calculate the previous
|
||
|
|
run date of the expression. You can calculate dates far into the future or past by
|
||
|
|
skipping n number of matching dates.
|
||
|
|
|
||
|
|
The parser can handle increments of ranges (e.g. */12, 2-59/3), intervals (e.g. 0-9),
|
||
|
|
lists (e.g. 1,2,3), W to find the nearest weekday for a given day of the month, L to
|
||
|
|
find the last day of the month, L to find the last given weekday of a month, and hash
|
||
|
|
(#) to find the nth weekday of a given month.
|
||
|
|
|
||
|
|
Installing
|
||
|
|
==========
|
||
|
|
|
||
|
|
Add the dependency to your project:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
composer require mtdowling/cron-expression
|
||
|
|
```
|
||
|
|
|
||
|
|
Usage
|
||
|
|
=====
|
||
|
|
```php
|
||
|
|
<?php
|
||
|
|
|
||
|
|
require_once '/vendor/autoload.php';
|
||
|
|
|
||
|
|
// Works with predefined scheduling definitions
|
||
|
|
$cron = Cron\CronExpression::factory('@daily');
|
||
|
|
$cron->isDue();
|
||
|
|
echo $cron->getNextRunDate()->format('Y-m-d H:i:s');
|
||
|
|
echo $cron->getPreviousRunDate()->format('Y-m-d H:i:s');
|
||
|
|
|
||
|
|
// Works with complex expressions
|
||
|
|
$cron = Cron\CronExpression::factory('3-59/15 2,6-12 */15 1 2-5');
|
||
|
|
echo $cron->getNextRunDate()->format('Y-m-d H:i:s');
|
||
|
|
|
||
|
|
// Calculate a run date two iterations into the future
|
||
|
|
$cron = Cron\CronExpression::factory('@daily');
|
||
|
|
echo $cron->getNextRunDate(null, 2)->format('Y-m-d H:i:s');
|
||
|
|
|
||
|
|
// Calculate a run date relative to a specific time
|
||
|
|
$cron = Cron\CronExpression::factory('@monthly');
|
||
|
|
echo $cron->getNextRunDate('2010-01-12 00:00:00')->format('Y-m-d H:i:s');
|
||
|
|
```
|
||
|
|
|
||
|
|
CRON Expressions
|
||
|
|
================
|
||
|
|
|
||
|
|
A CRON expression is a string representing the schedule for a particular command to execute. The parts of a CRON schedule are as follows:
|
||
|
|
|
||
|
|
* * * * * *
|
||
|
|
- - - - - -
|
||
|
|
| | | | | |
|
||
|
|
| | | | | + year [optional]
|
||
|
|
| | | | +----- day of week (0 - 7) (Sunday=0 or 7)
|
||
|
|
| | | +---------- month (1 - 12)
|
||
|
|
| | +--------------- day of month (1 - 31)
|
||
|
|
| +-------------------- hour (0 - 23)
|
||
|
|
+------------------------- min (0 - 59)
|
||
|
|
|
||
|
|
Requirements
|
||
|
|
============
|
||
|
|
|
||
|
|
- PHP 5.3+
|
||
|
|
- PHPUnit is required to run the unit tests
|
||
|
|
- Composer is required to run the unit tests
|