(PHP 5, PHP 7, PHP 8)
stream_get_contents — Lê o restante de um fluxo em uma string
Idêntico a file_get_contents(), exceto que stream_get_contents() opera em um recurso de fluxo já aberto e retorna o conteúdo remanescente em uma string, até o número de bytes definido em length e iniciando na posição offset especificada.
stream (resource)Um recurso de fluxo (ex.: retornado de fopen())
length (int) O máximo de bytes para leitura. O padrão é null (ler todo o buffer remanescente).
offset (int)Posiciona o ponteiro até o deslocamento especificado antes da leitura. Se o número for negativo, não irá ocorrer deslocamento e a leitura irá iniciar na posição atual.
Retorna uma string ou false em caso de falha.
| Versão | Descrição |
|---|---|
| 8.0.0 | length agora pode ser nulo. |
Exemplo #1 Exemplo de stream_get_contents()
<?php
if ($stream = fopen('http://www.example.com', 'r')) {
// mostra toda a página iniciando na posição 10
echo stream_get_contents($stream, -1, 10);
fclose($stream);
}
if ($stream = fopen('http://www.example.net', 'r')) {
// mostra os 5 primeiros bytes
echo stream_get_contents($stream, 5);
fclose($stream);
}
?>Nota: Esta função é compatível com dados binários.
Nota:
Ao especificar um valor de
lengthdiferente denull, esta função irá imediatamente alocar um buffer interno deste tamanho, mesmo que o conteúdo real seja significativamente menor.