Forum und email

socket_read

(PHP 4 >= 4.0.7, PHP 5)

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

Beschreibung

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

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 (oder auch, wenn der entfernte Socket die Verbindung abgebrochen hat). 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.

Hinweis: socket_read() kann auch einen leeren String zurückgeben (""), wenn es keine Daten mehr zu lesen gibt.

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().