ftp_rename

(PHP 4, PHP 5, PHP 7)

ftp_rename — Renomme un fichier sur un serveur FTP

Description

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

ftp_rename() renomme le fichier ou le dossier oldname en newname, sur le serveur ftp_stream.

Liste de paramètres

ftp_stream

L'identifiant du lien de connexion FTP.

oldname

L'ancien nom du dossier / fichier.

newname

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.

Exemples

Exemple #1 Exemple avec ftp_rename()

<?php
$old_file = 'somefile.txt.bak';
$new_file = 'somefile.txt';

// Mise en place d'une connexion basique
$conn_id = ftp_connect($ftp_server);

// Identification avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// Tentative de renommage de $old_file en $new_file
if (ftp_rename($conn_id, $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($conn_id);
?>