PHP
Referenzliste
file_get_contents
Dateisystem-Funktionen
Befehl:
string file_get_contents ( string $filename [, bool $use_include_path = false [, resource $context [, int $offset = -1 [, int $maxlen ]]]] )
Parameter-Liste:
Beschreibung | |
---|---|
Name der zu lesenden Datei. | |
Hinweis: Seit PHP 5 kann FILE_USE_INCLUDE_PATH genutzt werden, um eine Suche im include path auszulösen. | |
Eine gültige Context-Ressource, die mit stream_context_create() erstellt wurde. Falls Sie keinen eigenen Context benötigen, können Sie diesen Parameter mit NULL überspringen. | |
Die Position, an der das Lesen im Originalstream beginnt. Das Springen an bestimmte Positionen ( offset ) wird nicht für entfernte Dateien unterstützt. Für kleine Offsets kann der Sprung funktionieren, allerdings ist dies nicht vorhersagbar, weil hierbei auf dem gepufferten Stream gearbeitet wird. | |
Maximale Länge der zu lesenden Daten. Standardmäßig wird solange gelesen bis das Ende der Datei erreicht wird. Beachten Sie, dass dieser Parameter auf den Stream angewendet wird, der durch die Filter verarbeitet wird. |
Rückgabewerte:
Die Funktion gibt die gelesenen Daten zurück. Im Fehlerfall wird
FALSE
zurückgegeben. Beschreibung:
Diese Funktion ist mit file() identisch, ausser dass file_get_contents() die Datei in einem String zurückgibt, beginnend am angebenen offset über bis zu maxlen Bytes. Im Fehlerfall gibt file_get_contents() FALSE zurück.
file_get_contents() ist der empfohlene Weg, um den Inhalt einer Datei in einen String zu lesen. Es werden Techniken zur Speicherabbildung genutzt, um die Performance zu erhöhen, falls das Betriebssystem dies unterstützt.
file_get_contents() ist der empfohlene Weg, um den Inhalt einer Datei in einen String zu lesen. Es werden Techniken zur Speicherabbildung genutzt, um die Performance zu erhöhen, falls das Betriebssystem dies unterstützt.
Hinweis:
Falls Sie einen URI mit speziellen Zeichen, wie z.B. Leerzeichen, öffnen, müssen den URI mittels urlencode() enkodieren.
Falls Sie einen URI mit speziellen Zeichen, wie z.B. Leerzeichen, öffnen, müssen den URI mittels urlencode() enkodieren.
Aktiv in Version:
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
Hinweis:
Hinweis:
Diese Funktion ist binary safe.
Tips:
Tips:
Mit dieser Funktion können Sie eine URL als Dateinamen verwenden, falls Sie fopen wrappers ermöglicht haben. Mehr Details dazu, wie Sie den Dateinamen angeben müssen finden Sie bei fopen(). Eine Liste der unterstützten URL Protokolle, die Fähigkeiten der verschiedenen Wrapper, Hinweise zu deren Verwendung und Informationen zu den eventuell vorhandenen vordefinierten Variablen finden Sie unter Unterstützte Protokolle and Wrappers.
Fehler:
Ein Fehler der Stufe
E_WARNING
wird generiert, wenn entweder maxlength
kleiner als Null ist oder wenn offset
die Länge des Streams überschreitet. Warnung:
Warnung:
Bei SSL-Verbindungen zusammen mit Microsoft IIS hält sich dieser Webserver nicht an das Protokoll und schliesst die Verbindung ohne ein close_notify zu senden. PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das Ende der Daten erreicht ist. Eine mögliche Lösung besteht darin, den Level von error_reporting herabzusetzten und Warnings auszuschliessen. Ab PHP 4.3.7 kann PHP fehlerhafte IIS-Serversoftware erkennen, wenn Sie einen Stream mit dem https://-Wrapper öffnen, und unterdrückt die Warnung für Sie. Falls Sie fsockopen() benutzen, um einen ssl://-Socket zu öffnen, müssen Sie selbst dafür Sorge tragen, die Warnung zu erkennen und diese zu unterdrücken.
Siehe auch:
file_get_contents() - Beispiel 1: Holen und Ausgeben des Quelltextes der Startseite einer Webseite
Eingabe:
<?php $homepage = file_get_contents('http://www.example.com/'); echo $homepage; ?>
Beschreibung:
Mit dieser Funktion k�nnen Sie eine URL als Dateinamen verwenden, falls Sie fopen wrappers erm�glicht haben. Mehr Details dazu, wie Sie den Dateinamen angeben m�ssen finden Sie bei fopen(). Eine Liste der unterst�tzten URL Protokolle, die F�higkeiten der verschiedenen Wrapper, Hinweise zu deren Verwendung und Informationen zu den eventuell vorhandenen vordefinierten Variablen finden Sie unter Unterst�tzte Protokolle and Wrappers.
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Die offset - und maxlen -Parameter wurden hinzugefügt. |
5.0.0 | Context-Unterstützung wurde hinzugefügt. |
file_get_contents() - Beispiel 2: Suche im include_path
Eingabe:
<?php // <= PHP 5 $file = file_get_contents('./leute.txt', true); // > PHP 5 $file = file_get_contents('./leute.txt', FILE_USE_INCLUDE_PATH); ?>
Beschreibung:
Bei SSL-Verbindungen zusammen mit Microsoft IIS h�lt sich dieser Webserver nicht an das Protokoll und schliesst die Verbindung ohne ein close_notify zu senden. PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das Ende der Daten erreicht ist. Eine m�gliche L�sung besteht darin, den Level von error_reporting herabzusetzten und Warnings auszuschliessen. Ab PHP 4.3.7 kann PHP fehlerhafte IIS-Serversoftware erkennen, wenn Sie einen Stream mit dem https://-Wrapper �ffnen, und unterdr�ckt die Warnung f�r Sie. Falls Sie fsockopen() benutzen, um einen ssl://-Socket zu �ffnen, m�ssen Sie selbst daf�r Sorge tragen, die Warnung zu erkennen und diese zu unterdr�cken.
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Die offset - und maxlen -Parameter wurden hinzugefügt. |
5.0.0 | Context-Unterstützung wurde hinzugefügt. |
file_get_contents() - Beispiel 3: Lesen einen Abschnitts einer Datei
Eingabe:
<?php // Lese 14 Zeichen, beginnend mit dem 21. Zeichen $section = file_get_contents('./leute.txt', NULL, NULL, 20, 14); var_dump($section); ?>
Ausgabe:
string(14) "lle Bjori Ro"
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Die offset - und maxlen -Parameter wurden hinzugefügt. |
5.0.0 | Context-Unterstützung wurde hinzugefügt. |
file_get_contents() - Beispiel 4: Nutzung von Stream-Contexten
Eingabe:
<?php // Erzeugen eines Streams $opts = array( 'http'=>array( 'method'=>"GET", 'header'=>"Accept-language: en\r\n" . "Cookie: foo=bar\r\n" ) ); $context = stream_context_create($opts); // Öffnen der Datei mit den oben definierten HTTP-Headern $file = file_get_contents('http://www.example.com/', false, $context); ?>
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Die offset - und maxlen -Parameter wurden hinzugefügt. |
5.0.0 | Context-Unterstützung wurde hinzugefügt. |
Dateisystem-Funktionen