PHP Dokumentation: Function socket-accept
12. Januar 2010 von werner
socket_accept
(PHP 4 >= 4.1.0, PHP 5)
socket_accept — Akzeptiert eine Verbindung an einem Socket
Beschreibung
Nachdem der Socket socket mit socket_create() erzeugt, mit socket_bind() mit einem Namen verknüpft und mit socket_listen() angewiesen wurde, nach hereinkommenden Verbindungsanforderungen zu horchen, werden sie mit dieser Funktion an dem Socket zugelassen. Nach einem erfogreichen Verbindungsaufbau wird ein neuer Socket-Deskriptor zurückgegeben, welcher zur Kommunikation benutzt werden kann. Gibt es mehrere Verbindungen an diesem Socket, werden diese in eine Warteschlange gestellt und die erste Verbindung wird benutzt. Falls es keine wartenden Verbindungen gibt, blockiert die Funktion socket_accept() so lange, bis eine Verbindung angefordert wird. Falls der Socket socket mit den Funktionen socket_set_blocking() oder socket_set_nonblock() auf 'nicht blockieren' gesetzt wurde, wird FALSE zurückgegeben.
Der Socket-Deskriptor, der von socket_accept() zurückgegeben wird, sollte nicht dazu benutzt werden, neue Verbindungen zuzulassen. Der ursprüngliche wartende Socket socket bleibt dagegen geöffnet und kann wiederverwendet werden.
Parameter-Liste
- socket
Ein gültiger Socket-Deskriptor, der von der Funktion socket_create() erzeugt wurde.
Rückgabewerte
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 socket_strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.
Siehe auch
- socket_connect() – Baut eine Verbindung über einen Socket auf
- socket_listen() – Hört einen Socket nach Verbindungsanforderungen ab
- socket_create() – Erzeugt einen Socket (Endpunkt für die Kommunikation)
- socket_bind() – Verknüpft einen Socket mit einem Namen
- socket_strerror() – Gibt einen String zurück, der einen socket-Fehler beschreibt