Funksjonen file_put_contents

Funksjonen file_put_contents skriver data til en fil. Den første parameteren er stien til filen, den andre er dataene som skal skrives. Den tredje valgfrie parameteren definerer skrivemodusen (se tabellen under).

Den fjerde valgfrie parameteren er en ressurs for strømkontekst, opprettet av funksjonen stream_context_create. Gjør det mulig å konfigurere parametere for arbeid med fil eller nettverksressurs.

Syntaks

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

Verdier for den tredje parameteren

Flagg	Beskrivelse
`FILE_USE_INCLUDE_PATH`	Hvis satt, vil funksjonen søke etter filen i kataloger spesifisert i include_path-parameteren i PHP-innstillingene i filen `php.ini`.
`FILE_APPEND`	Tilføye data til slutten av filen i stedet for å overskrive
`LOCK_EX`	Skaffe eksklusiv lås på filen under skrivingen

Eksempel

La oss skrive en streng til en fil:

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

Resultatet av kjøring av koden returnerer antall skrevne byte:

5

Eksempel

La oss tilføye data til slutten av filen:

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

Eksempel

Skrive en matrise til en fil:

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

Eksempel

I den tredje parameteren kan man spesifisere flere flagg, ved å liste dem opp med tegnet |. Som et eksempel, la oss tilføye data med låsing av filen:

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

Eksempel

Bruk av 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å

funksjonen file_get_contents,
som leser innholdet i en fil
funksjonen fopen,
som åpner en fil
funksjonen fwrite,
som skriver til en fil