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 Socketsocket, 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, vous pouvez 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 (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

    VersionDescription
    8.0.0socket est désormais une instance de Socket ; auparavant, c'était une resource.

    Voir aussi

    To Top