ftp_fget

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

    ftp_fget — Télécharge un fichier via FTP dans un fichier local

    Description

    ftp_fget(
        FTP\Connection$ftp,
        resource$stream,
        string$remote_filename,
        int$mode = FTP_BINARY,
        int$offset = 0
    ): bool

    ftp_fget() télécharge le fichier remote_filename depuis le serveur FTP et l'écrit dans le fichier identifié par stream.

    Liste de paramètres

    ftp

    Une instance de FTP\Connection.

    stream

    Un pointeur de fichier ouvert dans lequel on écrit les données.

    remote_filename

    Le chemin vers le fichier distant.

    mode

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

    offset

    La position du fichier distant à partir de laquelle le téléchargement commence.

    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 optionel. Précédemment il était obligatoire.

    Exemples

    Exemple #1 Exemple avec ftp_fget()

    <?php

    // Chemin vers le fichier distant
    $remote_file = 'somefile.txt';
    $local_file = 'localfile.txt';

    // Ouverture du fichier pour écriture
    $handle = fopen($local_file, 'w');

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

    // Tente de téléchargement le fichier $remote_file et de le sauvegarder dans $handle
    if (ftp_fget($ftp, $handle, $remote_file, FTP_ASCII, 0)) {
    echo     "Ecriture dans le fichier $local_file avec succès\n";
    } else {
    echo     "Il y a un problème lors du téléchargement du fichier $remote_file dans $local_file\n";
    }

    // Fermeture de la connexion et du pointeur de fichier
    ftp_close($ftp);
    fclose($handle);
    ?>

    Voir aussi

    • ftp_get() - Télécharge un fichier depuis un serveur FTP
    • 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