(PHP 5, PHP 7, PHP 8)
stream_get_line — Obtém uma linha do recurso do fluxo até um delimitador informado
Obtém uma linha do manipulador informado.
A leitura termina quando o número de bytes especificados em length tiverem sido lidos, ou quando
a string não vazia especificada por ending for encontrada (que
não é incluída no valor de retorno), ou em EOF
(o que ocorrer primeiro).
Esta função é praticamente idêntica a fgets() exceto por permitir delimitadores de final de linha diferente dos padrões \n, \r e \r\n, e não retorna o delimitador em si.
streamUm manipulador de arquivo válido.
length
O número máximo de bytes para leitura do manuipulador.
Valores negativos não são suportados.
Zero (0) define o tamanho padrão do pacote do socket,
isto é, 8192 bytes.
endingUm delimitador string opcional.
Retorna uma string com no máximo o número de bytes de length lidos do arquivo
apontado por stream, ou false em caso de falha.
fgets is faster but stream_get_line is more useful in a tcp server scripts.
when fgets reads some bytes from socket, where EOF is reached, it returns bool(false) same as stream_get_line
BUT if remote client drops connection, and server script will try to read some data with function fgets, function will return bool(false), and stream_get_line will return string(0) ""
so you can detect remote client disconnection with stream_get_line, and cannot with fgets