socket_write

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

socket_writeÉcrit dans un socket

Description

socket_write(Socket $socket, string $data, ?int $length = null): int|false

socket_write() écrit dans le socket socket les données du buffer data.

Liste de paramètres

socket

data

Le buffer à écrire.

length

Le paramètre optionnel length peut spécifier explicitement la taille des données qui doivent être écrites. Si cette longueur est plus grande que la taille de data, elle sera ramenée automatiquement à la taille de data lui-même.

Valeurs de retour

socket_write() retourne le nombre d'octets qui ont pu être écrits dans le socket ou false si une erreur survient. 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:

Il est parfaitement valide pour socket_write() de retourner zéro, ce qui signifie qu'aucun octet n'a été écrit. Soyez bien sûr d'utiliser l'opérateur === pour comparer le retour de la fonction avec false, et détecter un cas d'erreur.

Historique

Version Description
8.0.0 socket est désormais une instance de Socket ; auparavant, c'était une resource.
8.0.0 length est désormais nullable.

Notes

Note:

socket_write() n'écrit pas nécessairement tous les octets de data fourni. Il est valide que, suivant certaines configuration de buffer réseau, seulement une certaine quantité de données, même un octet, soit écrit, y compris si data est plus grand. Une boucle doit être utilisée pour s'assurer que tout le reste de data est transmit.

Voir aussi