file_put_contents
(PHP 5, PHP 7)
file_put_contents — Schreibt Daten in eine Datei
Beschreibung
$filename
, mixed $data
[, int $flags = 0
[, resource $context
]] ) : intDiese Funktion entspricht fopen(), fwrite() und fclose(), um Daten in eine Datei zu schreiben.
Wenn filename nicht existiert, wird die Datei erstellt.
Sonst wird die existierende Datei überschrieben, es sei denn
FILE_APPEND ist gesetzt.
Parameter-Liste
-
filename -
Pfad zur Datei in die die Daten geschrieben werden sollen.
-
data -
Die zu schreibenden Daten. Kann entweder string, oder array sowie stream sein.
Wenn
dataeine stream-Quelle ist, wird der verbleibende Puffer des Streams in die festgelegte Datei kopiert. Dies ähnelt der Funktion stream_copy_to_stream().Sie können auch den Parameter
dataals eindimensionales Array angeben. Dies ist äquivalent zu file_put_contents($filename, implode('', $array)). -
flags -
Der Wert von
flagskann eine Kombination der folgenden Flags sein, verbunden mit dem binären OR(|) -Operator.verfügbare Flags Flag Beschreibung FILE_USE_INCLUDE_PATHSucht nach filenameim enthaltenen Verzeichnis. Siehe include_path für mehr Information.FILE_APPENDFalls die Datei filenamebereits existiert, füge die Daten an die Datei an anstatt diese zu überschreiben.LOCK_EXErwirbt exklusive Schreibrechte auf die Datei während mit dem Schreiben fortgefahren wird. Anders ausgedrückt erfolgt ein flock() Aufruf zwischen dem fopen() Aufruf und dem fwrite() Aufruf. Das ist nicht das gleiche wie ein fopen() Aufruf mit Modus "x". -
context -
Eine gültige Kontakt-Ressource erstellt mit der Funktion stream_context_create().
Rückgabewerte
Diese Funktion gibt die Anzahl der geschriebenen Bytes oder
FALSE bei einem Fehler zurück.
Diese Funktion kann sowohl das
boolsche FALSE zurückliefern, als auch einen nicht-boolschen Wert, welcher zu FALSE ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
Beispiele
Beispiel #1 Einfaches Verwendungsbeispiel
<?php
$file = 'people.txt';
// Öffnet die Datei, um den vorhandenen Inhalt zu laden
$current = file_get_contents($file);
// Fügt eine neue Person zur Datei hinzu
$current .= "John Smith\n";
// Schreibt den Inhalt in die Datei zurück
file_put_contents($file, $current);
?>
Beispiel #2 Verwendung der Flags
<?php
$file = 'people.txt';
//Die neue Person, die zur Datei hinzugefügt werden soll
$person = "John Smith\n";
// Schreibt den Inhalt in die Datei
// unter Verwendung des Flags FILE_APPEND, um den Inhalt an das Ende der Datei anzufügen
// und das Flag LOCK_EX, um ein Schreiben in die selbe Datei zur gleichen Zeit zu verhindern
file_put_contents($file, $person, FILE_APPEND | LOCK_EX);
?>
Changelog
| Version | Beschreibung |
|---|---|
| 5.1.0 |
Unterstützung für LOCK_EX hinzugefügt und die Möglichkeit,eine Stream-Quelle als data-Parameter zu übergeben
|
Anmerkungen
Hinweis: Diese Funktion ist binary safe.
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 und Wrapper.
Siehe auch
- fopen() - Öffnet eine Datei oder URL
- fwrite() - Binär-sicheres Dateischreiben
- file_get_contents() - Liest die gesamte Datei in einen String
- stream_context_create() - Creates a stream context
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-function.file-put-contents.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
