La clase EvLoop

(PECL ev >= 0.2.0)

Introducción

Representa un bucle de eventos que siempre es distinto del bucle por defecto. A diferencia del bucle por defecto, no puede gestionar los watchers EvChild.

Al utilizar hilos, se debe crear un bucle por hilo, y utilizar el bucle por defecto en el hilo padre.

El bucle de eventos por defecto es inicializado automáticamente por Ev. Es accesible a través de los métodos de la clase Ev o mediante el método EvLoop::defaultLoop().

Sinopsis de la Clase

final class EvLoop {
/* Propiedades */
public $data;
public $backend;
public $iteration;
public $pending;
public $io_interval;
public $depth;
/* Métodos */
public __construct(
     int $flags = ?,
     mixed $data = NULL ,
     float $io_interval = 0.0 ,
     float $timeout_interval = 0.0
)
public backend(): int
final public check( string $callback , string $data = ?, string $priority = ?): EvCheck
final public child(
     string $pid ,
     string $trace ,
     string $callback ,
     string $data = ?,
     string $priority = ?
): EvChild
public static defaultLoop(
     int $flags = Ev::FLAG_AUTO ,
     mixed $data = NULL ,
     float $io_interval = 0. ,
     float $timeout_interval = 0.
): EvLoop
final public embed(
     string $other ,
     string $callback = ?,
     string $data = ?,
     string $priority = ?
): EvEmbed
final public fork( callable $callback , mixed $data = null , int $priority = 0 ): EvFork
final public idle( callable $callback , mixed $data = null , int $priority = 0 ): EvIdle
final public io(
     mixed $fd ,
     int $events ,
     callable $callback ,
     mixed $data = null ,
     int $priority = 0
): EvIo
public loopFork(): void
public now(): float
public nowUpdate(): void
final public periodic(
     float $offset ,
     float $interval ,
     callable $callback ,
     mixed $data = null ,
     int $priority = 0
): EvPeriodic
final public prepare( callable $callback , mixed $data = null , int $priority = 0 ): EvPrepare
public resume(): void
public run( int $flags = 0 ): void
final public signal(
     int $signum ,
     callable $callback ,
     mixed $data = null ,
     int $priority = 0
): EvSignal
final public stat(
     string $path ,
     float $interval ,
     callable $callback ,
     mixed $data = null ,
     int $priority = 0
): EvStat
public stop( int $how = ?): void
public suspend(): void
final public timer(
     float $after ,
     float $repeat ,
     callable $callback ,
     mixed $data = null ,
     int $priority = 0
): EvTimer
public verify(): void
}

Propiedades

data

Datos personalizados para adjuntar al bucle

backend

Solo lectura. Los flags del backend que indican el backend de eventos en uso.

is_default_loop

Solo lectura. true si es el bucle de eventos por defecto.

iteration

El contador de iteración actual del bucle. Ver el método Ev::iteration().

pending

El número de watchers pendientes. 0 indica que no hay watchers pendientes.

io_interval

Un valor alto para io_interval permite a libev pasar más tiempo recolectando los eventos EvIo, así, más eventos pueden ser gestionados por iteración, pero esto aumentará la latencia. Los tiempos de espera máximos (tanto para EvPeriodic como para EvTimer) no se verán afectados. Establecer esta opción a un valor distinto de cero introducirá una llamada adicional a sleep() en la mayoría de las iteraciones del bucle. El tiempo de pausa asegura que libev no consultará EvIo más de una vez durante este intervalo, en promedio. La mayoría de los programas pueden beneficiarse estableciendo io_interval a un valor cercano a 0.1, lo cual es generalmente suficiente para los servidores interactivos (y no destinados a juegos). Generalmente no tiene sentido establecer este valor a menos de 0.01, ya que se acerca a la granularidad a nivel de tiempos de la mayoría de los sistemas.

Ver también las »  funciones que controlan los bucles de eventos.

timeout_interval

Un valor alto para timeout_interval permite a libev pasar más tiempo recolectando los tiempos de espera máximos, pero como consecuencia aumenta la latencia, el estrés y la inexactitud (la función de retrollamada del watcher será llamada más tarde). Los watchers EvIo no se verán afectados. Establecer este valor a un valor no nulo no introducirá ninguna sobrecarga adicional a libev. Ver también las »  funciones que controlan los bucles de eventos.

depth

La profundidad de la recursión. Ver el método Ev::depth().

Tabla de contenidos

  • EvLoop::backend — Retorna un integer que describe el backend utilizado por libev
  • EvLoop::check — Crea un objeto EvCheck asociado con la instancia del bucle de eventos actual
  • EvLoop::child — Crea un objeto EvChild asociado con el bucle de eventos actual
  • EvLoop::__construct — Construye un objeto de bucle de eventos
  • EvLoop::defaultLoop — Devuelve o crea el bucle de eventos por omisión
  • EvLoop::embed — Crea una instancia del observador EvEmbed asociado con el objeto EvLoop actual
  • EvLoop::fork — Crea un objeto EvFork watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::idle — Crea un objeto EvIdle watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::invokePending — Invoca todos los watchers pendientes mientras sus estados de cola no sean reinicializados
  • EvLoop::io — Crea un objeto EvIo watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::loopFork — Debe ser llamado después de un fork
  • EvLoop::now — Devuelve el "event loop time" actual
  • EvLoop::nowUpdate — Establece el tiempo actual solicitándolo al kernel y actualiza el tiempo devuelto por EvLoop::now durante la ejecución
  • EvLoop::periodic — Crea un objeto EvPeriodic watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::prepare — Crea un objeto EvPrepare watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::resume — Reanuda un bucle de eventos previamente detenido
  • EvLoop::run — Comienza a verificar los eventos y a llamar a las funciones de retrollamada de la bucle
  • EvLoop::signal — Crea un objeto EvSignal watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::stat — Crea un objeto EvStat watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::stop — Detiene el bucle de eventos
  • EvLoop::suspend — Suspende el bucle
  • EvLoop::timer — Crea un objeto EvTimer watcher asociado con la instancia del bucle de eventos actual
  • EvLoop::verify — Realiza verificaciones de consistencia interna (para la depuración)
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top