(PHP 4 >= 4.1.0, PHP 5)
socket_read — Liest höchstens die angegebene Anzahl Bytes von einem Socket
$socket
, int $length
[, int $type = PHP_BINARY_READ
] )
Die Funktion socket_read() liest von dem Socket
socket, der entweder mit socket_create()
oder mit socket_accept() erzeugt wurde.
socket
Ein gültiger Socket-Deskriptor, der von socket_create() oder socket_accept() erzeugt wurde.
length
Die Anzahl Bytes, die höchstens gelesen wird, wird in dem Parameter
length angegeben. Anderenfalls können Sie mit
\r, \n, oder \0 den Lesevorgang beenden (dies ist abhängig von dem
Parameter type, siehe weiter unten).
type
Der optionale Parameter type ist eine
vordefinierte Konstante:
PHP_BINARY_READ (Standardwert) - benutzt die
Systemfunktion recv(). Das ist sicher zum Lesen
von Binärdaten.
PHP_NORMAL_READ - Lesevorgänge werden bei \n oder \r beendet.
socket_read() gibt bei Erfolg die Daten als String
zurück oder FALSE, falls ein Fehler aufgetreten ist (oder auch, 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.
| Version | Beschreibung |
|---|---|
| 4.1.0 |
Der Vorgabewert für type wurde von
PHP_NORMAL_READ auf
PHP_BINARY_READ gesetzt.
|