socket_write

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

socket_writeEscreve em um soquete

Descrição

socket_write(Socket $socket, string $data, ?int $length = null): int|false

A função socket_write() escreve no soquete socket os dados informados em data.

Parâmetros

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.

Valor Retornado

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 verificar false em caso de erro.

Registro de Alterações

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.

Notas

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, embora data seja maior. Um laço precisa ser usado para assegurar que o resto de data seja transmitido.

Veja Também