(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_rename — Renomme un fichier sur un serveur FTP
ftp_rename() renomme le fichier ou le dossier
from en to,
sur le serveur ftp.
ftpUne instance de FTP\Connection.
fromL'ancien nom du dossier / fichier.
toLe nouveau nom.
Cette fonction retourne true en cas de succès ou false si une erreur survient. En cas d'échec (comme tenter de renommer un fichier
inexistant), une erreur E_WARNING sera émise.
| Version | Description |
|---|---|
| 8.1.0 |
La paramètre ftp attend désormais une instance de
FTP\Connection ; auparavant, une ressource était attendu.
|
Exemple #1 Exemple avec ftp_rename()
<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';
// Mise en place d'une connexion basique
$ftp = ftp_connect($ftp_server);
// Identification avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// Tentative de renommage de $old_file en $new_file
if (ftp_rename($ftp, $old_file, $new_file)) {
echo "Renommage avec succès de $old_file en $new_file\n";
} else {
echo "Il y a eu un problème lors du renommage de $old_file en $new_file\n";
}
// Fermeture de la connexion
ftp_close($ftp);
?>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, byeYou 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...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');
?>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).