array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'class.event.php', 1 => 'Event', 2 => 'Класс Event', ), 'up' => array ( 0 => 'book.event.php', 1 => 'Event', ), 'prev' => array ( 0 => 'event.constructing.signal.events.php', 1 => 'Создаёт события для сигналов', ), 'next' => array ( 0 => 'event.add.php', 1 => 'Event::add', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/event/event.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.event.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Класс Event

(PECL event >= 1.2.6-beta)

Введение

Класс Event представляет и срабатывает на следующие события: файловый дескриптор готов к считыванию или записи; становится готов к считыванию или записи (только edge-triggered I/O (единовременное срабатывание)); заканчивается ожидание; получен системный сигнал; произошло пользовательское событие.

Каждое событие связано с объектом EventBase. Однако событие не обработается, пока событие не добавят методом Event::add(). Добавленное событие пребывает в статусе ожидания pending, пока оно не произошло. После этого событие переходит в статус active. Для обработки событий пользователь регистрирует функцию обратного вызова, которая вызывается в момент перехода события в активный статус. Событие вернётся в статус ожидания, если событие настроили со статусом persistent. После запуска callback-функции событие выйдет из режима ожидания, если не пребывает в статусе постоянноянного. Метод Event::del() удаляет событие из отслеживаемых и поэтому выводит событие из статуса ожидания. Событие добавляют повторно вызовом метода Event::add().

Обзор класса

final class Event {
/* Константы */
const int ET = 32;
const int PERSIST = 16;
const int READ = 2;
const int WRITE = 4;
const int SIGNAL = 8;
const int TIMEOUT = 1;
/* Свойства */
public readonly bool $pending;
/* Методы */
public add( float $timeout = ?): bool
public __construct(
     EventBase $base ,
     mixed $fd ,
     int $what ,
     callable $cb ,
     mixed $arg = NULL
)
public del(): bool
public free(): void
public static getSupportedMethods(): array
public pending( int $flags ): bool
public set(
     EventBase $base ,
     mixed $fd ,
     int $what = ?,
     callable $cb = ?,
     mixed $arg = ?
): bool
public setPriority( int $priority ): bool
public setTimer( EventBase $base , callable $cb , mixed $arg = ?): bool
public static signal(
     EventBase $base ,
     int $signum ,
     callable $cb ,
     mixed $arg = ?
): Event
public static timer( EventBase $base , callable $cb , mixed $arg = ?): Event
}

Свойства

pending

Указывает, пребывает ли событие в состоянии ожидания. Смотрите страницу «О постоянных событиях».

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

Event::ET

Указывает, что событие срабатывает по фронту (англ. edge-triggered) — генерируется один раз при изменении статуса, если базовый сервер событий поддерживает такое поведение. Это влияет на семантику флагов Event::READ и Event::WRITE.

Event::PERSIST

Указывает, что событие пребывает в статусе постоянного. Дополнительную информацию даёт страница «О постоянных событиях».

Event::READ

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

Event::WRITE

Флаг указывает событие, которое становится активным, когда предоставленный файл — часто потоковый ресурс или сокет — готов к записи.

Event::SIGNAL

Флаг указывают, чтобы реализовать отслеживание системных сигналов. Дополнительную информацию даёт страница «Создание событий для сигналов».

Event::TIMEOUT

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

Флаг Event::TIMEOUT игнорируется при создании события: флаг устанавливают при добавлении. Флаг указывают в аргументе $what функции обратного вызова, если произошло событие этого типа.

Содержание