realpath
rewind
Filesystem Functions
PHP Manual

# rename

(PHP 4, PHP 5)

rename — Renombra un archivo o directorio

### Descripción

bool rename ( string `$nombre_antiguo` , string `$nombre_nuevo` [, resource `$contexto` ] )

Intenta renombrar `nombre_antiguo` a `nombre_nuevo` .

### Lista de parámetros

`nombre_antiguo`

  > Note: El nombre antiguo. La envoltura usada en `nombre_antiguo` debe coincidir con la envoltura usada en `nombre_nuevo` .

`nombre_nuevo`

  El nuevo nombre.

`contexto`

  > Note: Soporte de contexto fue introducido con PHP.5.0.0.

### Valores retornados

Devuelve `TRUE` si todo se llevó a cabo correctamente, `FALSE` en caso de fallo.

### Registro de cambios

Versión | Descripción
--- | ---
5.0.0 | rename() puede usarse ahora también con algunas envolturas URL. Consulte Lista de Protocolos/Envolturas Soportadas para un listado de las envolturas que soportan rename().
4.3.3 | rename() as capaz ahora de renombrar archivos a través de particiones en sistemas basados en *nix.

### Ejemplos

Example #1 Ejemplo con rename()

`<?php
rename("/tmp/archivo_temp.txt", "/home/usuario/login/docs/mi_archivo.txt");
?>`

### Ver también

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

realpath
rewind
Filesystem Functions
PHP Manual