Renomme un fichier sur un serveur FTP

Description

ftp_rename(FTP\Connection $ftp, string $from, string $to): bool

ftp_rename() renomme le fichier ou le dossier from en to, sur le serveur ftp.

Liste de paramètres

ftp: Une instance de FTP\Connection.
from: L'ancien nom du dossier / fichier.
to: Le nouveau nom.

Valeurs de retour

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.

Historique

Version	Description
8.1.0	La paramètre `ftp` attend désormais une instance de FTP\Connection ; auparavant, une ressource était attendu.

Exemples

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