Función rename

La función rename renombra un archivo o directorio. El primer parámetro de la función acepta el nombre actual del archivo o la ruta al mismo, el segundo parámetro - el nuevo nombre o ruta. La función devuelve true en caso de éxito y false en caso de error.

Sintaxis

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

Ejemplo

Renombremos el archivo de 'old.txt' a 'new.txt':

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

Resultado de la ejecución del código:

phptrue

Ejemplo

Movamos el archivo a otro directorio:

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

Resultado de la ejecución del código:

phptrue

Ejemplo

Intentemos renombrar un archivo que no existe:

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

Resultado de la ejecución del código:

phpfalse

Ejemplo

Renombremos un directorio:

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

Resultado de la ejecución del código:

phptrue

Véase también