(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
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.
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
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 sidata
est plus grand. Une boucle doit être utilisée pour s'assurer que tout le reste dedata
est transmit.