array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'class.evtimer.php', 1 => 'EvTimer', 2 => 'Класс EvTimer', ), 'up' => array ( 0 => 'book.ev.php', 1 => 'Ev', ), 'prev' => array ( 0 => 'evstat.stat.php', 1 => 'EvStat::stat', ), 'next' => array ( 0 => 'evtimer.again.php', 1 => 'EvTimer::again', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ev/evtimer.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.evtimer.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Класс EvTimer

(PECL ev >= 0.2.0)

Введение

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

Таймеры базируются на реальном времени, поэтому при установке ежечасных повторений таймера и сбросе системных часов на январь прошлого года таймер всё равно продолжит срабатывать приблизительно каждый час. «Приблизительно» — потому что обнаружить скачки во времени сложно, а отдельные неточности неизбежны.

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

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

Обзор класса

class EvTimer extends EvWatcher {
/* Свойства */
public $repeat;
public $remaining;
/* Наследуемые свойства */
public $is_active;
public $data;
public $is_pending;
public $priority;
/* Методы */
public __construct(
     float $after ,
     float $repeat ,
     callable $callback ,
     mixed $data = null ,
     int $priority = 0
)
public again(): void
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
public EvWatcher::feed( int $revents ): void
public EvWatcher::getLoop(): EvLoop
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. Свойство remaining вернёт значение 4.0, когда таймер запустится и пройдёт 1 секунда. После истечения и перезапуска таймера свойство вернёт значение около 7.0; часто несколько меньше, поскольку запуск callback-функции занимает время.

Содержание