swoole_timer_tick
最后更新于：2022-04-02 06:30:55
# swoole\_timer\_tick
[TOC]
设置一个间隔时钟定时器，与`after`定时器不同的是`tick`定时器会持续触发，直到调用`swoole_timer_clear`清除。
~~~
int swoole_timer_tick(int $msec, callable $callback, [$mixed $param]);
~~~
* `$msec`指定时间，单位为毫秒。如`1000`表示`1秒`，最大不得超过`86400000`
* `$callback_function`时间到期后所执行的函数，必须是可以调用的
* 可以使用匿名函数的`use`语法传递参数到回调函数中
* 定时器仅在当前进程空间内有效
* 定时器是纯异步实现的，不能与阻塞IO的函数一起使用，否则定时器的执行时间会发生错乱
> 定时器在执行的过程中可能存在一定误差
## 回调函数
定时器触发的回调函数接受`2`个参数。第二个参数 $param 为可选参数
~~~
function callbackFunction(int $timer_id, [$mixed $param]);
~~~
* `$timer_id`定时器的ID，可用于`swoole_timer_clear`清除此定时器
* `$params`由`swoole_timer_tick`传入的第三个参数$param，此参数也为可选参数
## 定时器校正
定时器回调函数的执行时间不影响下一次定时器执行的时间。实例：在`0.002s`设置了`10ms`的`tick`定时器，第一次会在`0.012s`执行回调函数，如果回调函数执行了`5ms`，下一次定时器仍然会在`0.022s`时触发，而不是`0.027s`。
但如果定时器回调函数的执行时间过长，甚至覆盖了下一次定时器执行的时间。底层会进行时间校正，丢弃已过期的行为，在下一时间回调。如上面例子中`0.012s`时的回调函数执行了`15ms`，本该在`0.022s`产生一次定时回调。实际上本次定时器在`0.027s`才返回，这时定时早已过期。底层会在`0.032s`时再次触发定时器回调。
## 协程模式
在协程环境下`swoole_timer_tick`回调中会自动创建一个协程，可以直接使用协程相关`API`，无需调用`go`创建协程。
> 可设置`enable_coroutine`关闭自动创建协程
## 使用示例
~~~
swoole_timer_tick(1000, function(){
echo "timeout\n";
});
~~~
**正确示例**
~~~
swoole_timer_tick(3000, function () {
echo "after 3000ms.\n";
swoole_timer_after(14000, function () {
echo "after 14000ms.\n";
});
});
~~~
**错误示例**
~~~
swoole_timer_tick(3000, function () {
echo "after 3000ms.\n";
sleep(14);
echo "after 14000ms.\n";
});
~~~
';