Manual do PHP
Anterior |  | Próxima

# socket_read

(PHP 4 >= 4.1.0, PHP 5)

socket_read -- Lê um comprimento máximo de bytes de um socket

## Descrição

string socket_read ( resource socket, int length [, int type] )

Atenção
Esta função é EXPERIMENTAL. Isso quer dizer que o comportamento desta função e seu nome, incluindo TUDO o que está documentado aqui pode mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO. Esteja avisado, e use esta função por sua própria conta e risco.

A função socket_read() lê o socket resource `socket` criado pelas funções socket_create() ou socket_accept(). O número máximo de bytes lidos é especificado pelo parâmetro `length`. Caso contrário você pode usar \r, \n, uo \0 para finalizar a leitura (dependendo do parâmetro `type`, veja abaixo).

socket_read() retorna dados como uma string em caso de sucesso, ou `FALSE` em caso de erro. O código de erro pode ser retornado com socket_last_error(). Esse código deve ser passado para socket_strerror() para pegar uma explicação textual do erro.

> Nota: socket_read() deve retornar uma string de comprimento zero ("") indicando o fim da comunicação (ex. o ponto final remoto encerra a conexão).

O parâmetro opcional `type` é usado com constantes:

- PHP_BINARY_READ - usa a função do sistema `read()`. Seguro para leitura de dados binários. (Padrão no PHP >= 4.1.0)

- PHP_NORMAL_READ - lê até o final em \n ou \r. (Padrão no PHP <= 4.0.6)

Veja também socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_last_error(), socket_strerror() e socket_write().

Anterior | Principal | Próxima
socket_listen | Acima | socket_recv