array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.rename.php', 1 => 'rename', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.realpath.php', 1 => 'realpath', ), 'next' => array ( 0 => 'function.rewind.php', 1 => 'rewind', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/rename.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
rename — Renombra un fichero o directorio
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
oldname
debe coincidir con la envoltura usada ennewname
.
newname
El nuevo nombre.
context
Nota: Soporte para context fue añadido en PHP 5.0.0. Para una descripción de
contexts
, refiérase a Flujos.
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");
?>