Manuel PHP
Précédent |  | Suivant

# socket_read

(PHP 4 >= 4.1.0, PHP 5)

socket_read -- Lit des données d'une socket

## Description

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

Avertissement
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 chaîne 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 optionnel 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().

Précédent | Sommaire | Suivant
socket_listen | Niveau supérieur | socket_readv