zgcasas / cron-expression
PHP的CRON表达式:计算下一次或上一次运行日期,并确定CRON表达式是否应该运行
v2.0.2
2024-06-25 07:56 UTC
Requires
- php: ^7.2|^8.0
- webmozart/assert: ^1.0
Requires (Dev)
- phpstan/extension-installer: ^1.0
- phpstan/phpstan: ^1.0
- phpstan/phpstan-webmozart-assert: ^1.0
- phpunit/phpunit: ^7.0|^8.0|^9.0
Replaces
This package is auto-updated.
Last update: 2024-09-25 08:34:22 UTC
README
PHP CRON表达式解析器可以解析CRON表达式,确定是否应该运行,计算表达式的下一次运行日期和上一次运行日期。您可以通过跳过n个匹配日期来计算未来或过去很远的日期。
解析器可以处理范围增量(例如 */12, 2-59/3)、间隔(例如 0-9)、列表(例如 1,2,3)、W以找到给定月份的最近的工作日,L以找到该月的最后一天,L以找到该月的最后给定工作日,以及hash(#)以找到给定月份的第n个工作日。
安装
将依赖项添加到您的项目中
composer require mtdowling/cron-expression
用法
<?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表达式
CRON表达式是一个表示特定命令执行计划的字符串。CRON计划的组成部分如下
* * * * * *
- - - - - -
| | | | | |
| | | | | + 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)
要求
- PHP 5.3+
- 需要PHPUnit来运行单元测试
- 需要Composer来运行单元测试