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

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

Példa

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

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

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

phptrue

Példa

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

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

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

phptrue

Példa

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

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

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

phpfalse

Példa

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

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

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

phptrue

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