Renombra un fichero o un directorio

# rename

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

rename — Renombra un fichero o un directorio

### Descripción

function 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 contexto de flujo.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Ejemplos

Ejemplo #1 Ejemplo con rename()

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

### Ver también

- copy() - Copia un fichero
- unlink() - Elimina un fichero
- move_uploaded_file() - Mueve un archivo subido a una nueva ubicación

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open