ftp_get

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

    ftp_get — Télécharge un fichier depuis un serveur FTP

    Description

    ftp_get(
        FTP\Connection$ftp,
        string$local_filename,
        string$remote_filename,
        int$mode = FTP_BINARY,
        int$offset = 0
    ): bool

    ftp_get() télécharge le fichier remote_filename depuis le serveur FTP, et le sauve dans le fichier local local_filename.

    Liste de paramètres

    ftp

    Une instance de FTP\Connection.

    local_filename

    Le chemin vers le fichier local (sera écrasé si le fichier existe déjà).

    remote_filename

    Le chemin vers le fichier distant.

    mode

    Le mode de transfert. Doit être soit FTP_ASCII, soit FTP_BINARY.

    offset

    La position dans le fichier distant à partir duquel on commence le téléchargement.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Historique

    VersionDescription
    8.1.0 La paramètre ftp attend désormais une instance de FTP\Connection ; auparavant, une ressource était attendu.
    7.3.0 Le paramètre mode est maintenant optionnel. Précédemment il était obligatoire.

    Exemples

    Exemple #1 Exemple avec ftp_get()

    <?php

    // Définition de quelques variables
    $local_file = 'local.zip';
    $server_file = 'server.zip';

    // 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 téléchargement du fichier $server_file et sauvegarde dans le fichier $local_file
    if (ftp_get($ftp, $local_file, $server_file, FTP_BINARY)) {
    echo     "Le fichier $local_file a été écrit avec succès\n";
    } else {
    echo     "Il y a un problème\n";
    }

    // Fermeture de la connexion
    ftp_close($ftp);

    ?>

    Voir aussi

    • ftp_pasv() - Active ou désactive le mode passif
    • ftp_fget() - Télécharge un fichier via FTP dans un fichier local
    • ftp_nb_get() - Lit un fichier sur un serveur FTP, et l'écrit dans un fichier (non bloquant)
    • ftp_nb_fget() - Lit un fichier sur un serveur FTP, et l'écrit dans un fichier (non bloquant)
    To Top