PHP
Referenzliste
fread
Dateisystem-Funktionen
Befehl:
string fread ( resource $handle , int $length )
Parameter-Liste:
Beschreibung | |
---|---|
Eine Dateisystemressource (resource), wie sie in der Regel von fopen() zurückgegeben wird. | |
Bis zu length Bytes lesen. |
Rückgabewerte:
Gibt die ausgelesene Zeichenkette zurück. Im Fehlerfall wird
FALSE
zurückgegeben. Beschreibung:
liest bis zu length Bytes vom Dateizeiger handle. Das Lesen wird beendet, sobald eine der folgenden Bedingungen eintritt:
•length Bytes wurden gelesen
•Das Dateiende (EOF, end of file) wurde erreicht
•Ein Paket wird verfügbar oder eine Socket-Zeitüberschreitung tritt auf (Bei Netzwerk-Streams)
•Falls dieser Stream beim Lesen gepuffert wird und keine reguläre Datei repräsentiert, wird maximal einmal ein Stück bis zur maximalen Chunkgrösse (normalerweise 8192 Bytes) gelesen. Abhängig von den bisher gepufferten Daten können die zurückgelieferten Daten grösser als die Chunkgrösse sein.
•length Bytes wurden gelesen
•Das Dateiende (EOF, end of file) wurde erreicht
•Ein Paket wird verfügbar oder eine Socket-Zeitüberschreitung tritt auf (Bei Netzwerk-Streams)
•Falls dieser Stream beim Lesen gepuffert wird und keine reguläre Datei repräsentiert, wird maximal einmal ein Stück bis zur maximalen Chunkgrösse (normalerweise 8192 Bytes) gelesen. Abhängig von den bisher gepufferten Daten können die zurückgelieferten Daten grösser als die Chunkgrösse sein.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Hinweis:
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:
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.
Warnung:
Warnung:
Auf Systemen, welche zwischen Binär- und Textdateien (z.B. Windows) unterscheiden, muss die Datei mit 'b' im fopen() Mode-Parameter geöffnet werden.
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.
Siehe auch:
• fwrite()
Schreibt Binärdaten in eine Datei
• fopen()
Öffnet eine Datei oder URL
Stellt eine Internet- oder Unix-Domain-Socket-Verbindung her
• popen()
Öffnet einen Prozesszeiger
• fgets()
Liest eine Zeile von der Position des Dateizeigers
• fgetss()
Liest eine Zeile von der Position des Dateizeigers und entfernt HTML Tags.
• fscanf()
Interpretiert den Input einer Datei entsprechend einem angegebenen Format
• file()
Liest eine komplette Datei in ein Array
Gibt alle verbleibenden Daten eines Dateizeigers direkt aus.
• ftell()
Ermittelt die aktuelle Position des Dateizeigers
• rewind()
Setzt den Dateizeiger auf das erste Byte der Datei
fread() - Beispiel:
Eingabe:
<?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); ?> <?php $filename = "c:\\files\\somepic.gif"; $handle = fopen($filename, "rb"); $contents = fread($handle, filesize($filename)); fclose($handle); ?> <?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"); $contents = ''; while (!feof($handle)) { $contents .= fread($handle, 8192); } fclose($handle); ?>
Ausgabe:
Auf Systemen, welche zwischen Bin�r- und Textdateien (z.B. Windows) unterscheiden, muss die Datei mit b im fopen() Mode-Parameter ge�ffnet werden.
Dateisystem-Funktionen