README

这个库允许你只有一个通用的crontab条目，该条目将触发通过此库定义的几个不同的定时任务。Cron库将决定任务是否需要运行。

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

用例

假设你的应用程序需要两个定时任务。一个将文件夹的内容写入日志文件，另一个将清空文件夹。这个库允许你创建单独的脚本（例如：cron.php），其中你通知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 \Effiana\Job\ShellJob();
$job1->setCommand('ls -la /path/to/folder');
$job1->setSchedule(new \Effiana\Schedule\CrontabSchedule('*/5 * * * *'));

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

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

$cron = new \Effiana\Cron();
$cron->setExecutor(new \Effiana\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）。

贡献

所有代码贡献（包括有提交访问权限的人的贡献）都必须通过拉取请求进行，并由核心开发者批准后才能合并。这是为了确保对所有代码的正确审查。

分支项目，创建功能分支，并发送给我们拉取请求。

为了确保一致的代码库，你应该确保代码遵循我们从Symfony借用的编码标准。务必查看php-cs-fixer，这将对您有很大帮助。

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

需求

PHP 5.5.0 或更高版本

作者和贡献者

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

请参阅参与此项目的贡献者列表。

许可

Cron是在MIT许可下发布的。