rename

(PHP 4, PHP 5, PHP 7, PHP 8)

renameRenombra un fichero o directorio

Descripción

rename(string $oldname, string $newname, resource $context = ?): bool

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

Parámetros

oldname

Nota:

El nombre antiguo. La envoltura usada en oldname debe coincidir con la envoltura usada en newname.

newname

El nuevo nombre.

context

Un resource de contextos de 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 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.

Ejemplos

Ejemplo #1 Ejemplo con rename()

<?php
rename
("/tmp/fichero_tmp.txt", "/home/user/login/docs/mi_fichero.txt");
?>

Ver también