stream_get_contents

(PHP 5, PHP 7, PHP 8)

stream_get_contentsReads remainder of a stream into a string

Descrizione

stream_get_contents(resource $stream, ?int $length = null, int $offset = -1): string|false

Identical to file_get_contents(), except that stream_get_contents() operates on an already open stream resource and returns the remaining contents in a string, up to length bytes and starting at the specified offset.

Elenco dei parametri

stream (resource)

A stream resource (e.g. returned from fopen())

length (int)

The maximum bytes to read. Defaults to null (read all the remaining buffer).

offset (int)

Seek to the specified offset before reading. If this number is negative, no seeking will occur and reading will start from the current position.

Valori restituiti

Returns a string o false in caso di fallimento.

Log delle modifiche

Versione Descrizione
8.0.0 length is now nullable.

Esempi

Example #1 stream_get_contents() example

<?php

if ($stream = fopen('http://www.example.com', 'r')) {
// print all the page starting at the offset 10
echo stream_get_contents($stream, -1, 10);

fclose($stream);
}


if (
$stream = fopen('http://www.example.net', 'r')) {
// print the first 5 bytes
echo stream_get_contents($stream, 5);

fclose($stream);
}

?>

Note

Nota: Questa funzione è binary-safe (gestisce correttamente i file binari)

Nota:

When specifying a length value other than null, this function will immediately allocate an internal buffer of that size even if the actual contents are significantly shorter.

Vedere anche:

  • fgets() - Prende una riga da un puntatore a file
  • fread() - Legge un file salvaguardando la corrispondenza binaria
  • fpassthru() - Invia tutti i dati rimanenti su un puntartore a file

add a note

User Contributed Notes 2 notes

up
12
clarck dot smith at gmail dot com
12 years ago
In that case when stream_get_contents/fread/fgets or other stream reading functions block indefinitely your script because they don't reached the limit of bytes to read use the socket_get_meta_data function to figure out the number of the bytes to read. It returns an array that contains a key named 'unread_bytes' and then pass that number to your favourite stream reading functions second parameter to read from the stream.

Maybe a good workaround to use the stream_select function, and set the socket to non-blocking mode with the use of stream_set_blocking($stream, 0). In this case the socket reading functions work properly.

Cheers, Ervin
up
4
m rahman
13 years ago
When omitting the parameter $maxlength, any received bytes are stacked up until the underlying stream is not readable anymore, the the function returns that stack in one piece.
To Top