Renomme un fichier sur un serveur FTP

# ftp_rename

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

ftp_rename — Renomme un fichier sur un serveur FTP

### Description

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

    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open