(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_write — Escreve em um soquete
A função socket_write() escreve no soquete
socket os dados informados em
data.
socket
dataO buffer para escrita.
length
O parâmetro opcional length pode especificar um
comprimento alternativo de bytes escritos no soquete. Se esse comprimento for
maior que o comprimento de data,
ele será truncado silenciosamente para o comprimento de data.
Retorna o número de bytes escritos com sucesso no soquete ou false em caso de falha.
O código de erro pode ser recuperado com
socket_last_error(). Este código pode ser passado para
socket_strerror() para obter uma explicação textual do
erro.
Nota:
É perfeitamente válido que socket_write() retorne zero, o que significa que nenhum byte foi escrito. Certifique-se de usar o operador
===para verificarfalseem caso de erro.
| Versão | Descrição |
|---|---|
| 8.0.0 |
O parâmetro socket agora espera uma instância de Socket;
anteriormente, um resource era esperado.
|
| 8.0.0 |
length agora pode ser nulo.
|
Nota:
socket_write() não escreve necessariamente todos os bytes do parâmetro
datafornecido. É válido que, dependendo dos buffers de rede etc., apenas uma certa quantidade de dados, mesmo que um byte, seja escrita, emboradataseja maior. Um laço precisa ser usado para assegurar que o resto dedataseja transmitido.