(PHP 4, PHP 5, PHP 7)
fread — Liest Binärdaten aus einer Datei
$handle
, int $length
) : string
fread() liest bis zu
length Bytes vom Dateizeiger
handle. Das Lesen wird beendet, sobald
eine der folgenden Bedingungen eintritt:
length Bytes wurden gelesen
Gibt die ausgelesene Zeichenkette zurück. Im Fehlerfall wird FALSE zurückgegeben.
Beispiel #1 Ein einfaches fread()-Beispiel
<?php
// liest den Inhalt einer Datei in einen String
$filename = "/usr/local/etwas.txt";
$handle = fopen($filename, "r");
$contents = fread($handle, filesize($filename));
fclose($handle);
?>
Beispiel #2 Ein fread()-Beispiel mit einer Binärdatei
Auf Systemen, welche zwischen Binär- und Textdateien (z.B. Windows) unterscheiden, muss die Datei mit 'b' im fopen() Mode-Parameter geöffnet werden.
<?php
$filename = "c:\\files\\somepic.gif";
$handle = fopen($filename, "rb");
$contents = fread($handle, filesize($filename));
fclose($handle);
?>
Beispiel #3 fread()-Beispiele für entfernte Dateien
Wenn aus etwas gelesen werden soll, was keine normale lokale Datei ist, wie etwa Streams von entfernten Dateien oder von popen() und fsockopen(), so wird das Lesen beendet sobald ein Paket verfügbar ist. Das bedeutet, dass man die Daten in Stücken sammeln muss. Dies wird im unteren Beispiel gezeigt.
<?php
// Für PHP5 und höher
$handle = fopen("http://www.example.com/", "rb");
$contents = stream_get_contents($handle);
fclose($handle);
?>
<?php
$handle = fopen("http://www.example.com/", "rb");
if (FALSE === $handle) {
exit("Konnte Stream von URL nicht öffnen");
}
$contents = '';
while (!feof($handle)) {
$contents .= fread($handle, 8192);
}
fclose($handle);
?>
Hinweis:
Wenn man nur den Inhalt einer Datei in eine Zeichenkette lesen will, so sollte man file_get_contents() verwenden, da dies eine bessere Performance hat als der obige Code.
Hinweis:
Beachten Sie, dass fread() an der aktuellen Position im Dateizeiger zu lesen beginnt. Verwenden Sie ftell(), um herauszufinden wo dieser Zeiger steht und die Funktion rewind(), um den Zeiger zurückzustellen.