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

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

Esimerkki

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

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

Koodin suorituksen tulos:

phptrue

Esimerkki

Siirretään tiedosto toiseen hakemistoon:

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

Koodin suorituksen tulos:

phptrue

Esimerkki

Yritetään nimetä uudelleen olematonta tiedostoa:

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

Koodin suorituksen tulos:

phpfalse

Esimerkki

Nimetään hakemisto uudelleen:

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

Koodin suorituksen tulos:

phptrue

Katso myös