socket_listen
socket_recv
Socket Funktionen
PHP Manual

# 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.

### Parameter-Liste

`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.

### Rückgabewerte

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.

### ChangeLog

Version | Beschreibung
--- | ---
4.1.0 | Der Vorgabewert für `type` wurde von `PHP_NORMAL_READ` auf `PHP_BINARY_READ` gesetzt.

### Siehe auch

- socket_accept()
- socket_bind()
- socket_connect()
- socket_listen()
- socket_last_error()
- socket_strerror()
- socket_write()

socket_listen
socket_recv
Socket Funktionen
PHP Manual