socket_create_listen
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_create_listen — Öffnet einen Socket, um Verbindungen über einem gegebenen Port aufzubauen
Beschreibung
socket_create_listen() erzeugt eine neue
Socket-Instanz 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 alsbacklog
übergeben werden. Mehr Informationen hierzu finden Sie bei socket_listen().
Rückgabewerte
socket_create_listen() gibt bei Erfolg eine neue
Socket-Instanz 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.
Changelog
Version | Beschreibung |
---|---|
8.0.0 | Bei Erfolg gibt diese Funktion nun eine Socket-Instanz zurück; zuvor wurde eine Ressource zurückgegeben. |
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