# rename

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

rename — Renombra un fichero o directorio

### Descripción

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

Intenta renombrar `oldname` a `newname`, moviéndolo a otro directorio si fuera necesario. Si `newname` existe, lo sobrescribirá.

### Parámetros

`oldname`

  > Nota:

  > El nombre antiguo. La envoltura usada en `oldname` debe coincidir con la envoltura usada en `newname`.

`newname`

  El nuevo nombre.

`context`

  > Nota: Soporte para context fue añadido en PHP 5.0.0. Para una descripción de `contexts`, refiérase a Flujos.

### Valores devueltos

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

### Historial de cambios

Versión | Descripción
--- | ---
5.3.1 | rename() ahora puede renombrar ficheros a través de controladores de Windows.
5.0.0 | rename() ahora también puede emplearse con algunas envolturas de URL. Consulte Protocolos y Envolturas soportados para un listado de las envolturas que admite rename().
4.3.3 | rename() ahora es capaz de renombrar ficheros a través de particiones en sistemas basados en *nix, proporcinando los permisos apropiados. Se pueden generar advertencias si el sistema de ficheros destino no permite llamadas al sistema de `chown()` o `chmod()` hechas sobre ficheros; por ejemplo, si el sistema de ficheros destino en un sistema de ficheros FAT.

### Ejemplos

Ejemplo #1 Ejemplo con rename()

`<?php
rename("/tmp/fichero_tmp.txt", "/home/user/login/docs/mi_fichero.txt");
?>`

### Ver también

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