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] )

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` ou `\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 (y compris si l'hôte distant a fermé la connexion). 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() retourne une chaîne de longueur zéro (""), lorsqu'il n'y a plus de données à lire.

Le paramètre optionnel `type` peut prendre l'une des valeurs constantes suivantes :

- `PHP_BINARY_READ` : utilise la fonction système `recv()`. 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_recv