socket_read

(PHP 4 >= 4.1.0, PHP 5)

socket_readLit des données d'un socket

Description

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

socket_read() lit des données dans le socket socket, qui doit être une ressource créée par la fonction socket_create() ou la fonction socket_accept().

Liste de paramètres

socket

Une ressource de socket valide, créée par la fonction socket_create() ou la fonction socket_accept().

length

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

type

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

  • PHP_BINARY_READ (Défaut) - utilise la fonction système recv(). Capable de lire les données binaires.
  • PHP_NORMAL_READ - la lecture s'arrête aux \n et \r

Valeurs de retour

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.

Historique

Version Description
4.1.0 La valeur par défaut du paramètre type est passée de PHP_NORMAL_READ à PHP_BINARY_READ

Voir aussi

LoadingChargement en cours