Funktion file_put_contents

Die Funktion file_put_contents schreibt Daten in eine Datei. Der erste Parameter ist der Pfad zur Datei, der zweite sind die zu schreibenden Daten. Der dritte optionale Parameter bestimmt den Schreibmodus (siehe Tabelle unten).

Der vierte optionale Parameter ist eine Stream-Kontext-Ressource, erstellt von der Funktion stream_context_create. Ermöglicht die Konfiguration von Parametern für die Arbeit mit Datei- oder Netzwerkressourcen.

Syntax

file_put_contents(
	string $filename,
	mixed $data,
	int $flags = 0,
	?resource $context = null
): int|false

Werte des dritten Parameters

Flag	Beschreibung
`FILE_USE_INCLUDE_PATH`	Wenn gesetzt, sucht die Funktion nach der Datei in den Verzeichnissen, die im Parameter include_path in den PHP-Einstellungen in der Datei `php.ini` angegeben sind.
`FILE_APPEND`	Daten an das Ende der Datei anhängen anstatt sie zu überschreiben
`LOCK_EX`	Eine exklusive Sperre der Datei für die Dauer des Schreibvorgangs erhalten

Beispiel

Lassen Sie uns eine Zeichenkette in eine Datei schreiben:

<?php
	$res = file_put_contents('data.txt', 'abcde');
	echo $res;
?>

Das Ergebnis der Codeausführung gibt die Anzahl der geschriebenen Bytes zurück:

5

Beispiel

Lassen Sie uns Daten an das Ende der Datei anhängen:

<?php
	$res = file_put_contents('data.txt', '12345', FILE_APPEND);
	echo $res;
?>

Beispiel

Schreiben eines Arrays in eine Datei:

<?php
	$data = ['a', 'b', 'c'];
	$res = file_put_contents('array.txt', implode(',', $data));
	echo $res;
?>

Beispiel

Im dritten Parameter können mehrere Flags angegeben werden, indem sie durch das Symbol | aufgelistet werden. Als Beispiel hängen wir Daten mit einer Dateisperre an:

<?php
	$res = file_put_contents(
		'log.txt',
		"text",
		FILE_APPEND | LOCK_EX
	);
	echo $res;
?>

Beispiel

Verwendung eines Kontexts:

<?php
	$opts = [
		'http' => [
			'method' => "POST",
			'header' => "Content-type: text/plain\r\n"
		]
	];
	
	$context = stream_context_create($opts);
	
	$res = file_put_contents(
		'http://example.com/api',
		'data=test',
		false,
		$context
	);
?>

Siehe auch

die Funktion file_get_contents,
die den Inhalt einer Datei liest
die Funktion fopen,
die eine Datei öffnet
die Funktion fwrite,
die in eine Datei schreibt