Google

NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7">
PHP Handbuch
ZurückNach 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ückZum AnfangNach vorne
socket_listenNach obensocket_readv