Funktionen file_put_contents

Funktionen file_put_contents skriver data til en fil. Den første parameter er stien til filen, den anden er dataene, der skal skrives. Den tredje valgfrie parameter definerer skrivetilstanden (se tabellen nedenfor).

Den fjerde valgfrie parameter er en ressource for strømmens kontekst, oprettet af funktionen stream_context_create. Tillader konfiguration af parametre for arbejde med filen eller netværksressourcen.

Syntaks

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

Værdier for tredje parameter

Flag	Beskrivelse
`FILE_USE_INCLUDE_PATH`	Hvis sat, vil funktionen søge efter filen i mapperne angivet i parametren include_path i PHP-indstillingerne i filen `php.ini`.
`FILE_APPEND`	Tilføj data til slutningen af filen i stedet for at overskrive
`LOCK_EX`	Opnå eksklusiv låsning af filen under skrivningen

Eksempel

Lad os skrive en streng til en fil:

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

Resultatet af kodeudførelsen returnerer antallet af skrevne bytes:

5

Eksempel

Lad os tilføje data til slutningen af filen:

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

Eksempel

Skrivning af array til fil:

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

Eksempel

I den tredje parameter kan man angive flere flag, ved at opremse dem med symbolet |. Som et eksempel, lad os tilføje data med fil-lås:

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

Eksempel

Brug af kontekst:

<?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
	);
?>

Se også

funktionen file_get_contents,
som læser indholdet af en fil
funktionen fopen,
som åbner en fil
funktionen fwrite,
som skriver til en fil