rename
(PHP 4, PHP 5, PECL zip:1.1.0-1.4.1)
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 .
Lista de parámetros
- nombre_antiguo
-
Note: El nombre antiguo. La envoltura usada en nombre_antiguo debe coincidir con la envoltura usada en nombre_nuevo .
- nombre_nuevo
-
El nuevo nombre.
- contexto
-
Note: Soporte de contexto fue introducido con PHP.5.0.0.
Valores retornados
Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.
Registro de cambios
| Versión | Descripción |
|---|---|
| 5.0.0 | rename() puede usarse ahora también con algunas envolturas URL. Consulte Lista de Protocolos/Envolturas Soportadas para un listado de las envolturas que soportan rename(). |
| 4.3.3 | rename() as capaz ahora de renombrar archivos a través de particiones en sistemas basados en *nix. |
Ejemplos
Example#1 Ejemplo con rename()
<?php
rename("/tmp/archivo_temp.txt", "/home/usuario/login/docs/mi_archivo.txt");
?>