PHP Conference Nagoya 2025

ftp_rename

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

ftp_renameRenombra 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);
?>

add a note

User Contributed Notes 4 notes

up
3
Hugo locobyte at hotmail dot NO_SPAM dot com
22 years ago
Using "ftp_rename" to move files to other directories on server ftp
..
...
if(ftp_rename($conn_ftp, $xfiles[$i], "./dirx/".$xfiles[$i])) {
echo "File $xfiles[$i] moved to ./dirx";
} else {
echo "ERROR!!!. The file could not be moved";
}
...
..
#-->>h2m, bye
up
2
alishahnovin at hotmail dot com
16 years ago
You want to make sure you check the existence of the new name before renaming files, because otherwise you could risk losing files. Just do a simple check with ftp_size with the new name. If it's !=-1, you're going to want to throw some kind of error, otherwise you'll be losing a file...
up
2
Hazem dot Khaled at gmail dot com
18 years ago
to rename the file or folder you should use ftp_chdir to select the current directory on ftp server or you should write the full path to file in old name and in new name

Ex. 1
<?php
// open the folder that have the file
ftp_chdir($conn_id, '/www/ftp-filemanager/');

// rename the file
ftp_rename($conn_id, 'file1.jpg', 'new_name_4_file.jpg');
?>

or write full path Ex. 2
<?
// rename the file
ftp_rename($conn_id, '/www/ftp-filemanager/file1.jpg', '/www/ftp-filemanager/new_name_4_file.jpg');
?>
up
-1
aventaria at hotmxxx dot com
17 years ago
This function isn't only able to rename files, but also folders. And it is not only able to rename them, but also move them, and, in the case of folders, their contents as well (so folders don't have to be empty to move). For example:

<?php
ftp_rename
($conn_id, "./dir1/dir2/", "./dir3/");
?>

Now the folder dir2 (which prevously was in folder dir1) has moved to the same folder as dir1, and it has kept its original contents (the content just moved along).
To Top