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