ftp_rename

(PHP 4, PHP 5)

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

Descripción

bool ftp_rename ( resource $secuencia_ftp , string $nombre_viejo , string $nombre_nuevo )

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

Lista de parámetros

secuencia_ftp: El identificador de enlace de la conexión FTP.
nombre_viejo: El nombre del archivo/directorio viejo.
nombre_nuevo: El nuevo nombre.

Valores retornados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Example#1 Ejemplo de ftp_rename()


<?php
$archivo_viejo = 'un_archivo.txt.bak';
$archivo_nuevo = 'un_archivo.txt';

// establecer la conexión básica
$id_con = ftp_connect($ftp_server);

// iniciar sesión con nombre de usuario y contraseña
$resultado_login = ftp_login($id_con, $ftp_nombre_usuario, $ftp_contrasenya);

// tratar de renombrar $archivo_viejo a $archivo_nuevo
if (ftp_rename($id_con, $archivo_viejo, $archivo_nuevo)) {
 echo "se ha renombrado $archivo_viejo a $archivo_nuevo con éxito\n";
} else {
 echo "Hubo un problema al renombrar $archivo_viejo a $archivo_nuevo\n";
}

// cerrar la conexión
ftp_close($id_con);
?>