Escreve em um soquete

# socket_write

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

socket_write — Escreve em um soquete

### Descrição

function 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

- socket_accept() - Aceita uma conexão em um soquete
- socket_bind() - Vincula um nome a um soquete
- socket_connect() - Inicia uma conexão em um soquete
- socket_listen() - Escuta uma conexão em um soquete
- socket_read() - Lê um máximo de bytes de um soquete
- socket_strerror() - Retorna uma string descrevendo um erro no soquete

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open