socket_read
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_read — Liest höchstens die angegebene Anzahl Bytes von einem Socket
Beschreibung
Die Funktion socket_read() liest von der
Socket-Instanz socket
, die
entweder mit socket_create() oder mit
socket_accept() erzeugt wurde.
Parameter-Liste
-
socket
-
Eine Socket-Instanz, die mit socket_create() oder socket_accept() erzeugt wurde.
-
length
-
Die Anzahl Bytes, die höchstens gelesen werden, wird in dem Parameter
length
angegeben. Anderenfalls können Sie mit\r
,\n
, oder\0
den Lesevorgang beenden (dies ist abhängig von dem Parametermode
, siehe weiter unten). -
mode
-
Der optionale Parameter
mode
ist eine vordefinierte Konstante:-
PHP_BINARY_READ
(Standardwert) - benutzt die Systemfunktionrecv()
. Das ist sicher zum Lesen von Binärdaten. -
PHP_NORMAL_READ
- Lesevorgänge werden bei\n
oder\r
beendet.
-
Rückgabewerte
socket_read() gibt bei Erfolg die Daten als String
zurück oder false
, falls ein Fehler aufgetreten ist (einschließlich, wenn
der entfernte Host die Verbindung abgebrochen hat). Der Fehlercode kann mit
socket_last_error() abgefragt werden. Dieser Fehlercode
kann an die Funktion socket_strerror() übergeben werden,
um eine textuelle Beschreibung des Fehlers zu erhalten.
Hinweis:
socket_read() gibt einen leeren String ("") zurück, wenn es keine Daten mehr zu lesen gibt.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
socket ist nun eine
Socket-Instanz; vorher war es eine
resource.
|
Siehe auch
- socket_accept() - Akzeptiert eine Verbindung an einem Socket
- socket_bind() - Verknüpft einen Socket mit einem Namen
- socket_connect() - Baut eine Verbindung über einen Socket auf
- 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
- socket_write() - Schreibt in einen Socket