socket_accept
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
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 eingehenden
Verbindungsanforderungen zu horchen, werden sie mit dieser Funktion an dem
Socket zugelassen. Nach einem erfogreichen Verbindungsaufbau wird eine neue
Socket-Instanz zurückgegeben, welche zur
Kommunikation benutzt werden kann. Gibt es an diesem Socket mehrere
Verbindungen in der Warteschlange wird die erste 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.
Die Socket-Instanz, die 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.
Rückgabewerte
Gibt bei Erfolg eine neue Socket-Instanz 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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 | Bei Erfolg gibt diese Funktion nun eine Socket-Instanz zurück; vorher wurde eine resource zurückgegeben. |
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
