# ftp_rename

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

ftp_rename — Renombra un archivo o un directorio en el servidor FTP

### Descripción

ftp_rename(resource `$ftp_stream`, string `$oldname`, string `$newname`): bool

ftp_rename() renombra un archivo o un directorio en el servidor FTP.

### Parámetros

`ftp_stream`

  El identificador de enlace de la conexión FTP.

`oldname`

  El nombre del archivo/directorio viejo.

`newname`

  El nuevo nombre.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de ftp_rename()

`<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';
// establecer una conexión básica
$conn_id = ftp_connect($ftp_server);
// iniciar sesión con nombre de usuario y contraseña
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
// intentar renombrar el archivo $old_file a $new_file
if (ftp_rename($conn_id, $old_file, $new_file)) {
echo "se ha renombrado $old_file a $new_file con éxito\n";
} else {
echo "Hubo un problema al renombrar $old_file a $new_file\n";
}
// cerrar la conexión ftp
ftp_close($conn_id);
?>`