array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.rename.php', 1 => 'rename', 2 => 'Renombra un fichero o un directorio', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.realpath-cache-size.php', 1 => 'realpath_cache_size', ), 'next' => array ( 0 => 'function.rewind.php', 1 => 'rewind', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/rename.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

rename

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

rename — Renombra un fichero o un directorio

Descripción

rename(string $from, string $to, ?resource $context = null): bool

Intenta renombrar from a to, moviéndolo de directorio si es necesario. Si se renombra un fichero y to existe, será sobrescrito. Si se renombra un directorio y to existe, esta función emite un aviso.

Parámetros

from

El nombre antiguo.

Nota:

El gestor utilizado en el argumento from DEBE ser el mismo que el utilizado en to.

to

El nuevo nombre.

Nota: En Windows, si to ya existe, debe poder ser escrito. De lo contrario rename() falla y emite un E_WARNING.

context

Un resource de contexto de flujo.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo con rename()

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

Ver también