Funktionen rename

Funktionen rename omdøber en fil eller mappe. Den første parameter tager det aktuelle filnavn eller stien til filen, den anden parameter tager det nye navn eller sti. Funktionen returnerer true ved succes og false ved fejl.

Syntaks

rename(string $oldname, string $newname, resource $context = null): bool

Eksempel

Lad os omdøbe filen fra 'old.txt' til 'new.txt':

<?php
	$res = rename('old.txt', 'new.txt');
	var_dump($res);
?>

Resultat af kodekørsel:

true

Eksempel

Lad os flytte filen til en anden mappe:

<?php
	$res = rename('file.txt', 'newdir/file.txt');
	var_dump($res);
?>

Resultat af kodekørsel:

true

Eksempel

Lad os prøve at omdøbe en fil, der ikke eksisterer:

<?php
	$res = rename('nonexistent.txt', 'new.txt');
	var_dump($res);
?>

Resultat af kodekørsel:

false

Eksempel

Lad os omdøbe en mappe:

<?php
	$res = rename('olddir', 'newdir');
	var_dump($res);
?>

Resultat af kodekørsel:

true

Se også

funktionen copy,
som kopierer en fil
funktionen unlink,
som sletter en fil
funktionen move_uploaded_file,
som flytter en uploadet fil