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

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

Näide

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

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

Koodi täitmise tulemus:

phptrue

Näide

Liigutame faili teise kataloogi:

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

Koodi täitmise tulemus:

phptrue

Näide

Proovime ümber nimetada olematut faili:

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

Koodi täitmise tulemus:

phpfalse

Näide

Nimetame kataloogi ümber:

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

Koodi täitmise tulemus:

phptrue

Vaata ka

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