(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_write — Escribe en un socket
socket_write() escribe en el socket
socket
los datos del buffer
data
.
socket
data
El buffer a escribir.
length
El parámetro opcional length
puede especificar
explícitamente el tamaño de los datos que deben ser escritos. Si esta
longitud es mayor que el tamaño de data
,
será reducida automáticamente al tamaño de data
mismo.
socket_write() devuelve el número de bytes que han
podido ser escritos en el socket o false
en caso de error.
El código de error generado puede ser obtenido llamando a la función
socket_last_error(). Este código de error
puede ser pasado a la función socket_strerror()
para obtener un mensaje de error, legible para humanos.
Nota:
Es perfectamente válido que socket_write() devuelva cero, lo que significa que ningún byte ha sido escrito. Asegúrese de utilizar el operador
===
para comparar el retorno de la función confalse
, y detectar un caso de error.
Versión | Descripción |
---|---|
8.0.0 |
socket is a Socket instance now;
previously, it was a resource.
|
8.0.0 |
length ahora es nullable.
|
Nota:
socket_write() no escribe necesariamente todos los bytes de
data
proporcionados. Es válido que, siguiendo ciertas configuraciones de buffer de red, solo una cierta cantidad de datos, incluso un byte, sea escrito, incluso sidata
es más grande. Un ciclo debe ser utilizado para asegurarse de que el resto dedata
sea transmitido.