array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.socket-read.php', 1 => 'socket_read', 2 => 'Lit des données d\'un socket', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Fonctions sur les sockets', ), 'prev' => array ( 0 => 'function.socket-listen.php', 1 => 'socket_listen', ), 'next' => array ( 0 => 'function.socket-recv.php', 1 => 'socket_recv', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sockets/functions/socket-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_read

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_read — Lit des données d'un socket

Description

socket_read(Socket $socket, int $length, int $mode = PHP_BINARY_READ): string|false

socket_read() lit des données depuis l'instance de Socket socket, créée par socket_create() ou socket_accept().

Liste de paramètres

socket

Une instance de Socket créée par socket_create() ou socket_accept().

length

Elle lit un maximum de length octets. Sinon, il est possible d'utiliser \r, \n ou \0 pour terminer la lecture (suivant la valeur choisie pour mode, voir ci-dessous).

mode

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

  • PHP_BINARY_READ (Par défaut) - utilise la fonction système recv(). Sûre pour la lecture de 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
8.0.0 socket est désormais une instance de Socket ; auparavant, c'était une resource.

Voir aussi