EventBufferEvent (class)

Introduction

(PECL event >= 1.2.6-beta)

代表Libevent的缓冲区事件。

通常应用程序想要执行一些数据缓冲，而不仅仅是响应事件。例如，当我们想写数据时，通常的模式看起来像：

确定我们想要将一些数据写入连接; 把这些数据放入缓冲区。

2. 等待连接变为可写

3. 尽可能多地写入数据

4. 请记住我们写了多少，如果我们还有更多的数据要写入，请等待连接再次变为可写。

这种缓冲I / O模式非常普遍，Libevent为它提供了一个通用机制。“缓冲区事件”由底层传输（如套接字），读取缓冲区和写入缓冲区组成。当底层传输已准备好被读取或写入时，它会提供回调，而不是常规事件，缓冲区事件在读取或写入足够数据时调用其用户提供的回调。

课程简介

final EventBufferEvent {

/* Constants */

const integer READING = 1 ;

const integer WRITING = 2 ;

const integer EOF = 16 ;

const integer ERROR = 32 ;

const integer TIMEOUT = 64 ;

const integer CONNECTED = 128 ;

const integer OPT_CLOSE_ON_FREE = 1 ;

const integer OPT_THREADSAFE = 2 ;

const integer OPT_DEFER_CALLBACKS = 4 ;

const integer OPT_UNLOCK_CALLBACKS = 8 ;

const integer SSL_OPEN = 0 ;

const integer SSL_CONNECTING = 1 ;

const integer SSL_ACCEPTING = 2 ;

/* Properties */

public integer $fd ;

public integer $priority ;

public readonly EventBuffer $input ;

public readonly EventBuffer $output ;

/* Methods */

public void close ( void )

public bool connect (  string $addr  )

public bool connectHost (  EventDnsBase $dns_base  ,  string $hostname  ,  int $port  [,  int $family  = EventUtil::AF_UNSPEC  ] )

public __construct (  EventBase $base  [,  mixed $socket  = NULL  [,  int $options  = 0  [,  callable $readcb  = NULL  [,  callable $writecb  = NULL  [,  callable $eventcb  = NULL  ]]]]] )

public static array createPair (  EventBase $base  [,  int $options  = 0  ] )

public bool disable (  int $events  )

public bool enable (  int $events  )

public void free ( void )

public string getDnsErrorString ( void )

public int getEnabled ( void )

public EventBuffer getInput ( void )

public EventBuffer getOutput ( void )

public string read (  int $size  )

public bool readBuffer (  EventBuffer $buf  )

public void setCallbacks (  callable $readcb  ,  callable $writecb  ,  callable $eventcb  [,  string $arg  ] )

public bool setPriority (  int $priority  )

public bool setTimeouts (  float $timeout_read  ,  float $timeout_write  )

public void setWatermark (  int $events  ,  int $lowmark  ,  int $highmark  )

public string sslError ( void )

public static EventBufferEvent sslFilter (  EventBase $base  ,  EventBufferEvent $underlying  ,  EventSslContext $ctx  ,  int $state  [,  int $options  = 0  ] )

public string sslGetCipherInfo ( void )

public string sslGetCipherName ( void )

public string sslGetCipherVersion ( void )

public string sslGetProtocol ( void )

public void sslRenegotiate ( void )

public static EventBufferEvent sslSocket (  EventBase $base  ,  mixed $socket  ,  EventSslContext $ctx  ,  int $state  [,  int $options  ] )

public bool write (  string $data  )

public bool writeBuffer (  EventBuffer $buf  )

}

属性

与缓冲区事件关联的数字文件描述符。通常表示一个绑定的套接字。等同于NULL，如果没有与缓冲区事件关联的文件描述符（套接字）。

优先

用于实现缓冲区事件的事件的优先级。

输入

底层输入缓冲区对象（EventBuffer）

产量

底层输出缓冲区对象（EventBuffer）

预定义的常量

EventBufferEvent::READING

在bufferevent的读取操作期间发生的事件。查看其他标志，了解它是哪个事件。

EventBufferEvent::WRITING

在bufferevent的写入操作期间发生的事件。查看其他标志，了解它是哪个事件。

EventBufferEvent::EOF

缓冲区事件得到文件结束指示。

EventBufferEvent::ERROR

在bufferevent操作期间发生错误。有关错误的更多信息，请调用EventUtil :: getLastSocketErrno（）和/或EventUtil :: getLastSocketError（）。

EventBufferEvent::TIMEOUTEventBufferEvent::CONNECTED

Finished a requested connection on the bufferevent.

EventBufferEvent::OPT_CLOSE_ON_FREE

当缓冲区事件被释放时，关闭底层传输。这将关闭底层套接字，释放底层缓冲区事件等。

EventBufferEvent::OPT_THREADSAFE

自动为bufferevent分配锁，以便在多个线程中使用它是安全的。

EventBufferEvent::OPT_DEFER_CALLBACKS

当这个标志被设置时，bufferevent延迟它的所有回调。请参阅»使用Libevent进行快速便携式无阻塞网络编程，延迟回调。

EventBufferEvent::OPT_UNLOCK_CALLBACKS

默认情况下，当bufferevent设置为线程安全时，只要调用任何用户提供的回调，就会保持缓冲区事件的锁定。设置此选项使Libevent在调用回调时释放缓冲区事件的锁定。

EventBufferEvent::SSL_OPEN

SSL握手完成

EventBufferEvent::SSL_CONNECTING

SSL当前正在执行作为客户端的协商

EventBufferEvent::SSL_ACCEPTING

SSL当前正在作为服务器执行协商

Introduction

课程简介

属性

预定义的常量

目录