socket_read

(PHP 4 >= 4.1.0)

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 optinnel type peut prendre l'une des valeurs constantes suivantes :

Voir aussi socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_last_error(), socket_strerror() et socket_write().