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

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

    ?>
    To Top