(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_write — Écrit dans un socket
$socket
, string $buffer
[, int $length
] )
socket_write() écrit dans le socket
socket
les données du buffer
buffer
.
socket
buffer
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 du buffer, elle sera ramenée
automatiquement à la taille du buffer lui-même.
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.
Note:
socket_write() n'écrit pas nécessairement tous les octets du buffer 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 votre buffer est plus grand. Vous devez alors vous assurer que vous n'avez pas oublié de transmettre le reste de vos données.