socket_accept

(PHP 4 >= 4.1.0, PHP 5)

socket_accept -- Akzeptiert eine Verbindung an einem Socket

Beschreibung

int socket_accept ( resource socket )

Warnung

Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

Nachdem der Socket socket mit der socket_create() erzeugt wurde, mit socket_bind() mit einem Namen verknuepft wurde und mit socket_listen() angewiesen wurde, nach hereinkommenden Verbindungsanforderungen zu horchen, wird der Socket mit dieser Funktion angewiesen, diese Verbindungsanforderungen zuzulassen. Wenn ein Verbindungsaufbau erfolgreich war, wird ein neuer Socket-Deskriptor 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 wartenden Verbindungsanforderungen gibt, blockiert die Funktion socket_accept() so lange, bis eine Verbindungsanforderung kommt. Falls socket mit der Funktion socket_set_blocking() oder mit socket_set_nonblock() auf 'nicht blockieren' gesetzt wurde, wird FALSE zurückgegeben.

Der Socket-Deskriptor, der von socket_accept() zurückgegeben wird, soll nicht dazu benutzt werden, um neue Verbindungsanforderungen zu benutzen. Der ursprüngliche wartende Socket socket bleibt geöffnet und kann wiederbenutzt werden.

Gibt bei Erfolg einen neuen Socket-Deskriptor zurück oder FALSE, falls ein Fehler auftritt. Der aktuelle Fehlercode kann mit der Funktion socket_last_error() ermittelt werden. Dieser Fehlercode kann an die Funktion strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Siehe auch: socket_bind(), socket_connect(), socket_listen(), socket_create() und socket_strerror().

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 17:57:08