7.99.28 socket_read()Lit des données d'une socket[ Exemples avec socket_read ] PHP 4 >= 4.1.0
string
socket_read (
resource
socket
,
int
length
,
int
type
)
Attention |
Cette fonction est
EXPERIMENTALE
. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.
|
socket_read
lit des données dans la socket
socket
, qui doit être une ressource créée par
socket_accept
. Elle lit un maximum de
length
octets. Sinon, vous pouvez utiliser
\r
,
\n
or
\0
pour terminer la lecture (suivant la valeur choisie pour
type
,
voir ci-dessous).
socket_read
retourne les données sous forme de
chaine en cas de succès, et
FALSE
sinon. Le code
d'erreur généré peut être obtenu en appelant la fonction
socket_last_error
. Ce code d'erreur
peut être passé à la fonction
socket_strerror
pour obtenir un message d'erreur, humainement lisible.
Note |
socket_read
peut retourner une chaîne de longueur
zéro, qui indique la fin de la communication (l'autre socket a fermé
la communication).
|
Le paramètre optinnel
type
peut prendre l'une des valeurs
constantes suivantes :
-
PHP_BINARY_READ - utilise la fonction système
read()
.
Capable de lire les données binaires. (valeur par défaut en PHP >= 4.1.0)
-
PHP_NORMAL_READ - la lecture s'arrête aux \n et \r.
(valeur par défaut en PHP <= 4.0.6)
Voir aussi
socket_accept
,
socket_bind
,
socket_connect
,
socket_listen
,
socket_last_error
,
socket_strerror
et
socket_write
.
|