accept_connect

(4.0.2 - 4.0.6 only)

accept_connect -- Weist den Socket an, hereinkommende Verbindungen zu bearbeiten

Beschreibung

int accept_connect (int socket)

Warnung

This function is EXPERIMENTAL. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this function at your own risk.

Nachdem der Socket socket mit der socket() erzeugt wurde, mit bind() mit einem Namen verknuepft wurde und mit listen() angewiesen wurde, auf hereinkommende Verbindungsanforderungen zu horchen, wird der Socket mit dieser Funktion angewiesen, hereinkommende Verbindungsanforderungen zuzulassen und zu bearbeiten. Wenn ein Verbindungsaufbau erfolgreich war, wird ein neuer Socket-Deskriptot zurückgegeben, welcher zur Kommunikation benutzt werden kann. Wenn es mehrere Verbindungsanforderungen an diesem Socket gibt, werden diese in eine Warteschlange gestellt und die erste Verbindungsanforderung wird bedient. Falls es keine aktuellen Verbindungsanforderungen gibt, blockiert die Funktion accept_connect() solange, bis eine Verbindungsanforderung kommt. Falls socket mit der Funktion socket_set_blocking() oder mit set_nonblock() auf 'nicht blockieren' gesetzt wurde, wird ein Fehlercode zurückgegeben.

Der Socket-Deskriptor, der von accept_connect() zurückgegeben wird, soll nicht dazu benutzt werden, um neue Verbindungsanforderungen zuzulassen. Der originäre wartende Socket socket bleibt geöffnet und kann wiederbenutzt werden.

Gibt einen neuen Socket-Deskriptor zurück oder einen negativen Fehlercode, falls ein Fehler auftritt. Dieser Fehlercode kann an die Funktion strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Siehe auch: bind(), connect(), listen(), socket(), socket_get_status(), und strerror().