A rename függvény

A rename függvény átnevez egy fájlt vagy könyvtárat. Az első paraméterben a függvény a fájl jelenlegi nevét vagy elérési útját veszi át, a második paraméterben az új nevet vagy elérési utat. A függvény true értékkel tér vissza sikeres végrehajtás esetén, és false értékkel hiba esetén.

Szintaxis

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

Példa

Nevezzük át a 'old.txt' fájlt 'new.txt' névre:

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

A kód végrehajtásának eredménye:

true

Példa

Helyezzük át a fájlt egy másik könyvtárba:

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

A kód végrehajtásának eredménye:

true

Példa

Próbáljunk meg egy nem létező fájlt átnevezni:

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

A kód végrehajtásának eredménye:

false

Példa

Nevezzük át a könyvtárat:

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

A kód végrehajtásának eredménye:

true

Lásd még

a copy függvényt,
amely fájlt másol
a unlink függvényt,
amely fájlt töröl
a move_uploaded_file függvényt,
amely feltöltött fájlt mozgat