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_recv |