Funktsioon rename

Funktsioon rename nimetab faili või kataloogi ümber. Esimese parameetrina võtab funktsioon faili praeguse nime või tee selle juurde, teise parameetrina - uue nime või tee. Funktsioon tagastab true edukal korral ja false vea korral.

Süntaks

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

Näide

Nimetame faili 'old.txt' ümber nimeks 'new.txt':

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

Koodi täitmise tulemus:

true

Näide

Liigutame faili teise kataloogi:

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

Koodi täitmise tulemus:

true

Näide

Proovime ümber nimetada olematut faili:

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

Koodi täitmise tulemus:

false

Näide

Nimetame kataloogi ümber:

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

Koodi täitmise tulemus:

true

Vaata ka

funktsiooni copy,
mis kopeerib faili
funktsiooni unlink,
mis kustutab faili
funktsiooni move_uploaded_file,
mis liigutab üleslaaditud faili