The EventListener class

(PECL event >= 1.5.0)


Represents a connection listener.

Class synopsis

final class EventListener {
/* Constants */
const int OPT_REUSEABLE = 8;
const int OPT_THREADSAFE = 16;
/* Properties */
public readonly int $fd;
/* Methods */
public __construct(
     EventBase $base ,
     callable $cb ,
     mixed $data ,
     int $flags ,
     int $backlog ,
     mixed $target
public disable(): bool
public enable(): bool
public getBase(): void
public static getSocketName( string &$address , mixed &$port = ?): bool
public setCallback( callable $cb , mixed $arg = null ): void



Numeric file descriptor of the underlying socket. (Added in event-1.6.0 .)

Predefined Constants


By default Libevent turns underlying file descriptors, or sockets, to non-blocking mode. This flag tells Libevent to leave them in blocking mode.


If this option is set, the connection listener closes its underlying socket when the EventListener object is freed.


If this option is set, the connection listener sets the close-on-exec flag on the underlying listener socket. See platform documentation for fcntl and FD_CLOEXEC for more information.


By default on some platforms, once a listener socket is closed, no other socket can bind to the same port until a while has passed. Setting this option makes Libevent mark the socket as reusable, so that once it is closed, another socket can be opened to listen on the same port.


Allocate locks for the listener, so that it’s safe to use it from multiple threads.

Table of Contents

add a note

User Contributed Notes

There are no user contributed notes for this page.