rename

rename(string $from, string $to, [resource $context]): bool
```php

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.

> [!NOTE]
> El gestor utilizado en el argumento `from` *DEBE* ser el mismo que el utilizado en `to`.

`to`  
El nuevo nombre.

> [!NOTE]
> En Windows, si `to` ya existe, debe poder ser escrito. De lo contrario `rename` falla y emite un `E_WARNING`.

`context`  
Un [contexto de flujo](#stream.contexts) de tipo `resource`.

## Valores devueltos

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

## Ejemplos

Ejemplo con `rename`