Funktio rename

Funktio rename nimeää tiedoston tai hakemiston uudelleen. Ensimmäisenä parametrina funktio ottaa nykyisen tiedoston nimen tai polun siihen, toisena parametrina - uuden nimen tai polun. Funktio palauttaa true onnistuessaan ja false virheen sattuessa.

Syntaksi

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

Esimerkki

Nimetään tiedosto 'old.txt' uudelleen nimelle 'new.txt':

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

Koodin suorituksen tulos:

true

Esimerkki

Siirretään tiedosto toiseen hakemistoon:

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

Koodin suorituksen tulos:

true

Esimerkki

Yritetään nimetä uudelleen olematonta tiedostoa:

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

Koodin suorituksen tulos:

false

Esimerkki

Nimetään hakemisto uudelleen:

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

Koodin suorituksen tulos:

true

Katso myös

funktion copy,
joka kopioi tiedoston
funktion unlink,
joka poistaa tiedoston
funktion move_uploaded_file,
joka siirtää ladatun tiedoston