# ftp_rename

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

ftp_rename — 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 resource é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);
?>`