stream_get_contents

(PHP 5, PHP 7, PHP 8)

stream_get_contentsReads remainder of a stream into a string

Beschreibung

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.

Parameter-Liste

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.

Rückgabewerte

Returns a stringBei einem Fehler wird false zurückgegeben..

Changelog

VersionBeschreibung
8.0.0length is now nullable.

Beispiele

Beispiel #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);
}

?>

Anmerkungen

Hinweis: Diese Funktion ist binärsicher.

Hinweis:

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.

Siehe auch

  • fgets() - Liest die Zeile von der Position des Dateizeigers
  • fread() - Liest Binärdaten aus einer Datei
  • fpassthru() - Gibt alle verbleibenden Daten eines Dateizeigers aus
To Top