(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 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 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 parâmetro
data
fornecido. É válido que, dependendo dos buffers de rede etc., apenas uma certa quantidade de dados, mesmo que um byte, seja escrita, emboradata
seja maior. Um laço precisa ser usado para assegurar que o resto dedata
seja transmitido.