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

Класс EventBase

(PECL event >= 1.2.6-beta)

Введение

Класс EventBase представляет структуру событийной базы модуля libevent. Класс содержит набор событий и умеет опрашивать события для определения, какие из событий активны.

Каждой событийной базе доступны метод или бэкенд, через которые определяют готовые события. Доступные методы: select, poll, epoll, kqueue, devpoll, evport и win32.

Класс EventConfig помогает настроить событийную базу или исключить отдельные бэкенды.

Внимание

НЕ разрушайте объект EventBase, пока не освободились связанные с объектом Event ресурсы, иначе результаты станут непредсказуемы!

Обзор класса

final class EventBase {
/* Константы */
const int LOOP_ONCE = 1;
const int LOOP_NONBLOCK = 2;
const int NOLOCK = 1;
const int STARTUP_IOCP = 4;
const int NO_CACHE_TIME = 8;
const int EPOLL_USE_CHANGELIST = 16;
/* Методы */
public __construct( EventConfig $cfg = ?)
public dispatch(): void
public exit( float $timeout = ?): bool
public free(): void
public getFeatures(): int
public getMethod(): string
public getTimeOfDayCached(): float
public gotExit(): bool
public gotStop(): bool
public loop( int $flags = ?): bool
public priorityInit( int $n_priorities ): bool
public reInit(): bool
public stop(): bool
}

Предопределённые константы

EventBase::LOOP_ONCE

Флаг указывают при вызове метода EventBase::loop() и указывает: «блокировать, пока модуль libevent не получит активное событие, а затем выйти после завершения callback-функции для всех активных событий».

EventBase::LOOP_NONBLOCK

Флаг указывают при вызове метода EventBase::loop() и означает: «не блокировать: посмотреть, какие события уже готовы, запустить обратные вызовы с наивысшим приоритетом, затем выйти».

EventBase::NOLOCK

Флаг конфигурации. Не выделять блокировку для событийной базы, даже если настроили блокирование.

EventBase::STARTUP_IOCP

Флаг конфигурации только для ОС Windows. Разрешает диспетчер IOCP при старте.

EventBase::NO_CACHE_TIME

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

EventBase::EPOLL_USE_CHANGELIST

На epoll-бэкендах флаг сообщает, что можно безопасно использовать внутренний код списка изменений Libevent для пакетного добавления и удаления в целях минимизации количества системных вызовов.

Установка флага часто повышает производительность, но иногда приводит к проявлению бага Linux: небезопасно использовать этот флаг, если какой-либо файловый дескриптор склонировали функцией dup() или аналогичной. Установка флага иногда приводит к странным ошибкам, которые трудно диагностировать.

Флаг также активируют установкой переменной окружения EVENT_EPOLL_USE_CHANGELIST.

Флаг действует только на epoll-бэкендах.

Содержание