# 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"; }); ~~~