Класс EvTimer

(PECL ev >= 0.2.0)

Введение

Наблюдатели EvTimer - это обычные относительные таймеры, которые создают событие через заданное время и, опционально, переодически повторяют его через заданные интервалы времени.

Таймеры базируются на реальном времени, то есть если задать таймер с повторами раз в час и сбросить системные часы на Январь прошлого года, то таймер будет все также срабатывать через (грубо) час. "Грубо" потому, что отследить скачки времени достаточно сложно и некоторые неточности неизбежны.

Callback-функция гарантированно запустится только после того, как пройдет заданный таймаут (не ровно в тот же момент, т.к. на системах с часами с низким разрешением могут наблюдаться небольшие задержки). Если несколько таймеров будут готовы сработать в одну и ту же итерацию событийного цикла, то callback-функции наблюдателей будут запущены в порядке времени срабатывания и с учетом приоритета (но это не работает, если callback-функции вызывают EvLoop::run() рекурсивно).

Сами по себе таймеры стараются всеми силами избежать накапливания ошибки, то есть если таймер сконфигурирован срабатывать каждые 10 секунд, то обычно он срабатывает точно с 10 секундным интервалом. Однако, если скрипт не поспевает за таймером, поскольку его работа занимает более 10 секунд, то таймер сработает не чаще чем один раз за итерацию событийного цикла.

Обзор классов

EvTimer extends EvWatcher {
/* Свойства */
public $repeat ;
public $remaining ;
/* Наследуемые свойства */
public $is_active ;
public $data ;
public $is_pending ;
public $priority ;
/* Методы */
public again ( ) : void
public __construct ( float $after , float $repeat , callable $callback , mixed $data = null , int $priority = 0 )
final public static createStopped ( float $after , float $repeat , callable $callback , mixed $data = null , int $priority = 0 ) : EvTimer
public set ( float $after , float $repeat ) : void
/* Наследуемые методы */
public EvWatcher::clear ( ) : int
abstract public EvWatcher::__construct ( )
public EvWatcher::feed ( int $revents ) : void
public EvWatcher::invoke ( int $revents ) : void
public EvWatcher::keepalive ( bool $value = ? ) : bool
public EvWatcher::setCallback ( callable $callback ) : void
public EvWatcher::start ( ) : void
public EvWatcher::stop ( ) : void
}

Свойства

repeat

Если равно 0.0, то таймер автоматически остановится, когда истечет таймаут. Если больше нуля, то таймер автоматически перейдет в режим бесконечного повторения через заданные интервалы, пока вы его самостоятельно не остановите.

remaining

Возвращает время, оставшееся до срабатывания таймера. Если таймер активен, то данное время будет считаться относительно времени текущего событийного цикла, а если таймер не активен, то оно будет равно сконфигурированному значению таймаута.

То есть, после того, как создан экземпляр EvTimer с after равным 5.0 и repeat равным 7.0, remaining вернет 5.0. Когда таймер запустится и пройдет 1 секунда, remaining вернет 4.0. когда таймер истечет и будет перезапущен, будет "грубо" возвращено 7.0 (обычно чуть меньше, так как запуск callback-функции занимает время) и т.д.

Содержание