(PHP 4, PHP 5)
rename — Renombra un archivo o directorio
Intenta renombrar oldname a newname.
Note:
El nombre anterior. La envoltura usada en oldname debe coincidir con la envoltura usada en newname.
El nuevo nombre.
Note: Soporte para context fue añadido en PHP 5.0.0. Para una descripción de contexts, refiérase a Funciones de Flujos.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
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 Lista de Protocolos/Envolturas Soportados para un listado de las envolturas que soporta rename(). |
4.3.3 | rename() ahora es capaz de renombrar archivos a través de particiones en sistemas basados en *nix, proporcinando los permisos apropiados. Se pueden generar advertencias si el sistema de archivos destino no permite llamadas al sistema de chown() o chmod() hechas sobre archivos — por ejemplo, si el sistema de archivos destino en un sistema de archivos FAT. |
Example #1 Ejemplo con rename()
<?php
rename("/tmp/archivo_tmp.txt", "/home/user/login/docs/mi_archivo.txt");
?>