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
lengthangegeben. Anderenfalls können Sie mit\r,\n, oder\0den Lesevorgang beenden (dies ist abhängig von dem Parametermode, siehe weiter unten). -
mode -
Der optionale Parameter
modeist 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\noder\rbeendet.
-
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
