(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_write — Écrit dans un socket
socket_write() écrit dans le socket
socket les données du buffer
data.
socket
dataLe 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.
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 avecfalse, et détecter un cas d'erreur.
| 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.
|
Note:
socket_write() n'écrit pas nécessairement tous les octets de
datafourni. 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 sidataest plus grand. Une boucle doit être utilisée pour s'assurer que tout le reste dedataest transmit.