PHP Handbuch
Zurück |  | Nach vorne

# socket_read

(PHP 4 >= 4.1.0)

socket_read -- Liest höchstens die angegebene Anzahl Bytes von einem Socket.

## Beschreibung

string socket_read ( resource socket, int length [, int type])

Warnung
Diese Funktion ist EXPERIMENTELL. Das Verhalten, der Funktionsname und alles Andere was hier dokumentiert ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien Sie gewarnt und verwenden Sie diese Funktion auf eigenes Risiko.

Die Funktion socket_read() liest von dem Socket `socket`, der entweder mit socket_create() oder mit socket_accept() erzeugt wurde. Die Anzahl Bytes, die höchstens gelesen wird, wird in dem Parameter `length` angegeben. Anderenfalls können Sie mit \r, \n, or \0 den Lesevorgang beenden (dies ist abhängig von dem Parameter `type`, siehe weiter unten).

socket_read() gibt bei Erfolg die Daten als String 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.

> Anmerkung: socket_read() kann auch einen leeren String zurückgeben (""), der das Ende der Kommunikation anzeigt (z.B. wenn der entfernte Host die Verbindung beendet hat).

Der optionale Parameter `type` ist eine vordefinierte Konstante:

- PHP_BINARY_READ - benutzt die `read()` Funktion des Systems. Sicher Zum Lesen von Binärdaten (und Standardeinstellung in PHP >= 4.1.0).

- PHP_NORMAL_READ - Der Lesevorgang wird mit \n oder \r beendet. (Standardeinstellung in PHP <= 4.0.6)

See also socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_last_error(), socket_strerror() und socket_write().

Zurück | Zum Anfang | Nach vorne
socket_listen | Nach oben | socket_readv