# 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

- socket_accept() - Accepte une connexion sur un socket
- socket_bind() - Lie un nom à un socket
- socket_connect() - Crée une connexion sur un socket
- socket_listen() - Attend une connexion sur un socket
- socket_read() - Lit des données d'un socket
- socket_strerror() - Retourne une chaîne décrivant un message d'erreur