README

这个库允许你只设置一个通用的crontab条目，它会触发通过此库定义的多个不同的定时任务。Cron库将决定任务是否需要执行。

注意：请确保将服务器cron任务的频率设置正确，因为如果代码中定义了每分钟运行一次的cron任务，那么你的通用cron任务也需要至少每分钟运行一次才能正常工作。

使用场景

假设你的应用程序需要两个cron任务。一个是将文件夹内容写入日志文件，另一个是清空文件夹。这个库允许你创建单独的脚本（例如：cron.php），在其中通知Cron库这两个cron任务。在定义了任务的详细信息后，可以将它们添加到解析器，并给出运行命令。

你的服务器crontab可能看起来像这样

* * * * * /path/to/php /path/to/cron.php >/dev/null 2>&1

下面的代码示例与此用例相匹配。

代码示例

<?php

require_once(__DIR__ . '/vendor/autoload.php');

// Write folder content to log every five minutes.
$job1 = new \Cron\Job\ShellJob();
$job1->setCommand('ls -la /path/to/folder');
$job1->setSchedule(new \Cron\Schedule\CrontabSchedule('*/5 * * * *'));

// Remove folder contents every hour.
$job2 = new \Cron\Job\ShellJob();
$job2->setCommand('rm -rf /path/to/folder/*');
$job2->setSchedule(new \Cron\Schedule\CrontabSchedule('0 0 * * *'));

$resolver = new \Cron\Resolver\ArrayResolver();
$resolver->addJob($job1);
$resolver->addJob($job2);

$cron = new \Cron\Cron();
$cron->setExecutor(new \Cron\Executor\Executor());
$cron->setResolver($resolver);

$cron->run();

Cron目前仅支持触发shell命令。这意味着你可以触发任何事情，尽管强烈建议不要调用Web URL。但如果你真的需要，这里有一些示例命令。

* * * * * /usr/bin/lynx -source http://example.com/cron.php
* * * * * /usr/bin/wget -O - -q -t 1 http://www.example.com/cron.php
* * * * * curl -s http://example.com/cron.php

安装

将以下内容添加到你的项目的composer.json文件中

$ composer require cron/cron

{
    "require": {
        "cron/cron": "^1.0"
    }
}

crontab语法

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)

每个部分都支持通配符（*），范围（2-5）和列表（2,5,6,11）。

贡献

所有代码贡献——包括具有提交访问权限的人的贡献——必须通过pull request进行，并经核心开发者批准后才能合并。这是为了确保对所有代码进行适当的审查。

将项目分支出来，创建一个功能分支，然后向我们发送一个pull request。

为了确保一致的代码库，你应该确保代码遵循我们从Symfony借用的编码规范。请务必查看php-cs-fixer，这将非常有帮助。

如果你想帮忙，请查看问题列表。

要求

PHP 5.5.0或更高版本

作者和贡献者

Dries De Peuter - dries@nousefreak.be - http://nousefreak.be

还可以查看参与此项目的贡献者列表。

许可

Cron采用MIT许可。