Funciones del Sistema de Archivos
PHP Manual

rename

(PHP 4, PHP 5)

renameRenombra un archivo o directorio

Descripción

bool rename ( string $oldname , string $newname [, resource $context ] )

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

Parámetros

oldname

Nota:

El nombre anterior. 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 archivos a través de controladores de Windows.
5.0.0 rename() ahora también puede ser usado con algunas envolturas URL. Consulte Protocolos y Envolturas soportados para un listado de las envolturas que soporta 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 archivos — por ejemplo, si el sistema de ficheros destino en un sistema de ficheros FAT.

Ejemplos

Ejemplo #1 Ejemplo con rename()

<?php
rename
("/tmp/archivo_tmp.txt""/home/user/login/docs/mi_archivo.txt");
?>

Ver también


Funciones del Sistema de Archivos
PHP Manual