Funkce rename

Funkce rename přejmenovává soubor nebo adresář. Prvním parametrem funkce přijímá současný název souboru nebo cestu k němu, druhým parametrem - nový název nebo cestu. Funkce vrací true v případě úspěchu a false v případě chyby.

Syntaxe

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

Příklad

Přejmenujeme soubor z 'old.txt' na 'new.txt':

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

Výsledek provedení kódu:

true

Příklad

Přesuneme soubor do jiného adresáře:

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

Výsledek provedení kódu:

true

Příklad

Zkusíme přejmenovat neexistující soubor:

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

Výsledek provedení kódu:

false

Příklad

Přejmenujeme adresář:

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

Výsledek provedení kódu:

true

Viz také

funkci copy,
která kopíruje soubor
funkci unlink,
která maže soubor
funkci move_uploaded_file,
která přesouvá nahraný soubor