(PHP 4, PHP 5, PHP 7)
rename — Renombra un fichero o directorio
$oldname
, string $newname
[, resource $context
] ) : bool
Intenta renombrar oldname a
newname, moviéndolo a otro directorio si fuera necesario.
Si newname existe, lo sobrescribirá.
oldname
Nota:
El nombre antiguo. La envoltura usada en
oldnamedebe coincidir con la envoltura usada ennewname.
newnameEl nuevo nombre.
contextNota: Soporte para context fue añadido en PHP 5.0.0. Para una descripción de contexts, refiérase a Flujos.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
| 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. |
Ejemplo #1 Ejemplo con rename()
<?php
rename("/tmp/fichero_tmp.txt", "/home/user/login/docs/mi_fichero.txt");
?>