rename

(PHP 4, PHP 5, PHP 7, PHP 8)

renameRenombra un fichero o un directorio

Descripción

rename(string $from, string $to, ?resource $context = null): bool

Intenta renombrar from a to, moviéndolo de directorio si es necesario. Si se renombra un fichero y to existe, será sobrescrito. Si se renombra un directorio y to existe, esta función emite un aviso.

Parámetros

from

El nombre antiguo.

Nota:

El gestor utilizado en el argumento from DEBE ser el mismo que el utilizado en to.

to

El nuevo nombre.

Nota: En Windows, si to ya existe, debe poder ser escrito. De lo contrario rename() falla y emite un E_WARNING.

context

Un resource de contextos de flujos.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con rename()

<?php
rename
("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>

Ver también