# socket_write

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

socket_write — Escribir en un socket

### Descripción

socket_write(resource `$socket`, string `$buffer`, int `$length` = 0): int

La función socket_write() escribe en el `socket` desde el `buffer` dado.

### Parámetros

`socket`

`buffer`

  El buffer a ser escrito.

`length`

  El parámetro opcional `length` puede especificar una longitud alternativa de bytes escritos en el socket. Si esta longitud es mayor que la longitud del buffer se trunca de forma silenciosa a la longitud del buffer.

### Valores devueltos

Devuelve el número de bytes escritos con éxito en el socket o `false` en caso de error. El código de error se puede recuperar con socket_last_error(). Este código se puede pasar a socket_strerror() para obtener una explicación textual del error.

> Nota:

> Es perfectamente válido que socket_write() devuelva cero, lo que significa que no se han escrito bytes. Asegúrese de usar el operador `===` para verificar `false` en caso de un error.

### Notas

> Nota:

> socket_write() no escribe necesariamente todos los bytes desde el buffer dado. Esto es válido ya que depende de los búferes de red, etc., sólo se escribe una cierta cantidad de informaicón, incluso un byte, aunque su buffer sea mayor. Debe tener cuidado de no olvidar inintencionadamente de transmitir el resto de la información.

### Ver también

- socket_accept() - Acepta una conexión de un socket
- socket_bind() - Vincula un nombre a un socket
- socket_connect() - Inicia una conexión sobre un socket
- socket_listen() - Escucha una conexión sobre un socket
- socket_read() - Lee un máximo de longitud de bytes desde un socket
- socket_strerror() - Devuelve una cadena que describe un error de socket