rename

(PHP 3, 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.

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

Ejemplo 1. Ejemplo con rename()

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

Nota: Antes de PHP 4.3.3, rename() no podía renombrar archivos a través de particiones diferentes bajo sistemas basados en Unix.

Nota: A partir de PHP 5.0.0, rename() puede usarse también con algunas envolturas URL. Consulte Apéndice M para un listado de las envolturas que soporta rename().

Nota: La envoltura usada en nombre_antiguo DEBE coincidir con la envoltura usada en nombre_nuevo.

Nota: Soporte de contexto fue introducido con PHP.5.0.0.

Vea también copy(), unlink(), y move_uploaded_file().

Hosting by: hurra.com
Generated: 2007-01-26 18:01:06