用Swoole 定时器实现毫秒级任务调度

Swoole 定时器简介

Swoole 提供了异步高精度定时器功能，该功能类似 JavaScript 的 setInterval/setTimeout，粒度为毫秒级，底层基于 epoll_wait（异步）和 setitimer（同步）实现，数据结构使用最小堆。定时器的添加和删除，全部为内存操作，无 IO 消耗，因此性能是非常高的。

需要注意的是，Swoole 实现的定时器与 PHP 自带的 pcntl_alarm不同，pcntl_alarm 是基于时钟信号和 tick 函数实现的，最大仅支持到秒，此外不支持同时设定多个定时器程序，性能也很差。

Swoole 提供了两种类型的定时器，一种是每隔一定时间执行的定时器，一种是指定时间后一次性执行的定时器，下面我们分别看看这两种定时器的实现和使用。

Swoole 定时器的使用

间隔时钟定时器

在 Swoole 中，我们可以通过 Timer::tick 实现间隔时钟定时器，该定时器会每隔指定时间触发 回调函数 的执行：

\Swoole\Timer::tick(1000,  function  () {
 echo "Swoole 很棒\n";
}); 

Swoole 定时器需要在 PHP CLI 模式下才能运行，上述代码的意思是每隔 1000ms 执行一次回调函数打印字符串：

指定时钟定时器

此外，还可以通过 Timer::after 定义一个指定时间后执行的定时器，与间隔时钟定时器不同，这种定时器是一次性的，执行完成后就会销毁：

\Swoole\Timer::after(3000, function () {
 echo "Laravel 也很棒\n";
}); 

上述定义器的含义是 3000ms 后执行指定的回调函数，并且执行之后就退出程序：

清除定时器

对于一次性执行的指定时钟定时器，不用关心清除问题，而对于间隔时钟定时器，如果不定义清楚逻辑的话，会永远执行下去，直到程序退出，我们可以通过 Timer::clear 删除定时器来达到清除的目的，在具体实现的时候，将定时器 ID 传入该方法即可，上述两种定时器定义方法都会返回对应的定时器 ID， 因此，清除定义器可以作用于上述两种定时器：

/*$timerId = \Swoole\Timer::tick(1000, function () {
 echo "Swoole 很棒\n";
});*/

$timerId = \Swoole\Timer::after(1000, function () {
 echo "Laravel 也很棒\n";
});

\Swoole\Timer::clear($timerId); 

这种情况下，两个定时器都不会调用，对于间隔时钟定时器，还可以这么清除：

$count = 0;
\Swoole\Timer::tick(1000, function ($timerId, $count) {
 global $count;
 echo "Swoole 很棒\n";
 $count++;
 if ($count == 3) {
 \Swoole\Timer::clear($timerId);
 }
}, $count); 

这种情况下，定时器会在执行三次后退出：

基于 Swoole 定时器实现毫秒级任务调度

我们可以基于 Swoole 定时器实现毫秒级调度任务来替代 Linux 自带的 Cron Job（最小粒度是分钟），以 Laravel 框架为例，我们可以基于LaravelS扩展包来定义一个继承自 CronJob 基类的调度任务类：

i, microtime(true)]);
 $this->i++;
 Log::info(__METHOD__, ['end', $this->i, microtime(true)]);

 if ($this->i == 3) { // 总共运行3次
 Log::info(__METHOD__, ['stop', $this->i, microtime(true)]);
 $this->stop(); // 清除定时器
 }
 }

 // 每隔 1000ms 执行一次任务
 public function interval()
 {
 return 1000; // 定时器间隔，单位为 ms
 }

 // 是否在设置之后立即触发 run 方法执行
 public function isImmediate()
 {
 return false;
 }
} 

然后到 config/laravels.php 配置文件中修改 timer 配置项如下：

'timer' => [
 'enable' => true,
 'jobs' => [
 // Enable LaravelScheduleJob to run `php artisan schedule:run` every 1 minute, replace Linux Crontab
 // \Hhxsv5\LaravelS\Illuminate\LaravelScheduleJob::class,
 // Two ways to configure parameters:
 // [\App\Jobs\XxxCronJob::class, [1000, true]], // Pass in parameters when registering
 \App\Jobs\Timer\TestCronJob::class, // Override the corresponding method to return the configuration
 ],
 'max_wait_time' => 5, // Max waiting time of reloading
], 

接下来，我们启动或重启 Swoole 服务器：

php bin/laravels start 

在 storage/logs 下的最新日志里就可以看到上述定时任务的输出了：

[2019-05-29 22:37:20] local.INFO: App\Jobs\Timer\TestCronJob::run ["start",0,1559140640.694025] 
[2019-05-29 22:37:20] local.INFO: App\Jobs\Timer\TestCronJob::run ["end",1,1559140640.752043] 
[2019-05-29 22:37:21] local.INFO: App\Jobs\Timer\TestCronJob::run ["start",1,1559140641.752905] 
[2019-05-29 22:37:21] local.INFO: App\Jobs\Timer\TestCronJob::run ["end",2,1559140641.754724] 
[2019-05-29 22:37:22] local.INFO: App\Jobs\Timer\TestCronJob::run ["start",2,1559140642.694884] 
[2019-05-29 22:37:22] local.INFO: App\Jobs\Timer\TestCronJob::run ["end",3,1559140642.696726] 
[2019-05-29 22:37:22] local.INFO: App\Jobs\Timer\TestCronJob::run ["stop",3,1559140642.698137] 

我们重点关注三个「start」的日志记录，对应的时间戳正好相差 1 秒，符合我们的预期。注意定时器在执行的过程中可能存在一定误差，所以这个毫秒数是数量级级别的，并不是完全相等，而且时间单位越小，误差可能越大，不过这已经比 Linux 自带的任务调度只能精确到分钟要好很多了。