socket_read
(PHP 4 >= 4.0.7, PHP 5)
socket_read — Lit des données d'une socket
Description
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().