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

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

Ejemplo

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

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

Resultado de la ejecución del código:

true

Ejemplo

Movamos el archivo a otro directorio:

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

Resultado de la ejecución del código:

true

Ejemplo

Intentemos renombrar un archivo que no existe:

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

Resultado de la ejecución del código:

false

Ejemplo

Renombremos un directorio:

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

Resultado de la ejecución del código:

true

Véase también

la función copy,
que copia un archivo
la función unlink,
que elimina un archivo
la función move_uploaded_file,
que mueve un archivo subido