anna7/cron-expression-php5

PHP的CRON:计算下一次或上一次运行日期,并确定CRON表达式是否到期

这个包的官方仓库似乎已经消失,因此包已被冻结。

v1.2.0.3 2017-06-20 16:36 UTC

This package is not auto-updated.

Last update: 2020-04-03 18:38:34 UTC


README

这只是重构了 mtdowling/cron-expression 包以支持PHP 5.6+

Latest Stable Version Total Downloads Build Status

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.6+
  • 需要PHPUnit来运行单元测试
  • 需要Composer来运行单元测试