socket_listen
socket_recv
Socket-Funktionen
PHP Manual

# socket_read

(PHP 4 >= 4.1.0, PHP 5)

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

### Beschreibung

string socket_read ( resource `$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.

### 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() - Akzeptiert eine Verbindung an einem Socket
- socket_bind() - Verknüpft einen Socket mit einem Namen
- socket_connect() - Baut eine Verbindung über einen Socket auf
- socket_listen() - Hört einen Socket nach Verbindungsanforderungen ab
- socket_last_error() - Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist
- socket_strerror() - Gibt einen String zurück, der einen socket-Fehler beschreibt
- socket_write() - Schreibt in einen Socket

socket_listen
socket_recv
Socket-Funktionen
PHP Manual