socket_create_listen

(PHP 4 >= 4.1.0, PHP 5)

socket_create_listen — Öffnet einen Socket, um Verbindungen über einem gegebenen Port aufzubauen

Beschreibung

resource socket_create_listen ( int $port [, int $backlog = 128 ] )

socket_create_listen() erzeugt einen neuen Socket-Deskriptor vom Typ AF_INET, der an allen lokalen Schnittstellen eines gegebenen Ports auf neue Verbindungen wartet.

Diese Funktion soll die Erzeugung eines neuen Sockets erleichtern, der nur auf neue Verbindungsanforderungen wartet, um sie zu akzeptieren.

Parameter-Liste

port: Der Port, den alle Schnittstellen abhören.
backlog: Der Parameter backlog gibt an, wie groß die Warteschlange mit wartenden Verbindungen maximal werden darf. SOMAXCONN kann als backlog übergeben werden. Mehr Informationen hierzu finden Sie bei socket_listen().

Rückgabewerte

socket_create_listen() gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder FALSE, falls ein Fehler aufgetreten ist. Der Fehlercode kann mit der Funktion socket_last_error() abgefragt werden. Dieser Fehlercode kann an die Funktion socket_strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Anmerkungen

Hinweis:
Falls Sie einen Socket erzeugen möchten, der nur bestimmte Schnittstellen abhört, müssen Sie socket_create(), socket_bind() und socket_listen() verwenden.

Siehe auch

socket_create() - Erzeugt einen Socket (Endpunkt für die Kommunikation)
socket_create_pair() - Erzeugt ein Paar nicht zu unterscheidender Sockets und speichert sie in einem Array
socket_bind() - Verknüpft einen Socket mit einem Namen
socket_listen() - Hört einen Socket nach Verbindungsanforderungen ab
socket_last_error() - Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist
socket_strerror() - Gibt einen String zurück, der einen socket-Fehler beschreibt