(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
data
O 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 do buffer, ele será truncado silenciosamente para o comprimento
do buffer.
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 verificarfalse
em 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 buffer fornecido. É válido que, dependendo dos buffers da rede etc., apenas uma certa quantidade de dados, mesmo que um byte, seja escrita, embora o seu buffer seja maior. Deve-se ter atenção para não esquecer involuntariamente de transmitir o restante dos dados.