Submit a Pull Request Report a Bug

    ftp_fget

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

    ftp_fget — Copia um arquivo do servidor FTP e salva em um arquivo aberto

    Descrição

    ftp_fget ( resource $ftp_stream , resource $handle , string $remote_file , int $mode , int $resumepos = ? ) : bool

    ftp_fget() obtém remote_file do servidor FTP, e escreve-o no ponteiro de arquivo dado.

    Parâmetros

    ftp_stream

    O identificador da conexão FTP.

    handle

    Um ponteiro de arquivo aberto no qual nós guardaremos os dados.

    remote_file

    O caminho do arquivo remoto.

    mode

    O modo de transferência. Deve ser FTP_ASCII ou FTP_BINARY.

    resumepos

    A posição no arquivo remoto a partir da qual começar a baixar.

    Valor Retornado

    Retorna true em caso de sucesso ou false em caso de falha.

    Exemplos

    Exemplo #1 Exemplo ftp_fget()

    <?php

    // path to remote file
    $remote_file = 'somefile.txt';
    $local_file = 'localfile.txt';

    // open some file to write to
    $handle = fopen($local_file, 'w');

    // set up basic connection
    $conn_id = ftp_connect($ftp_server);

    // login with username and password
    $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

    // try to download $remote_file and save it to $handle
    if (ftp_fget($conn_id, $handle, $remote_file, FTP_ASCII, 0)) {
     echo     "successfully written to $local_file\n";
    } else {
     echo     "There was a problem while downloading $remote_file to $local_file\n";
    }

    // close the connection and the file handler
    ftp_close($conn_id);
    fclose($handle);
    ?>

    Changelog

    Versão Descrição
    4.3.0 resumepos foi adicionado.

    Veja Também

    • ftp_get() - Copia um arquivo do servidor FTP
    • ftp_nb_get() - Obtém um arquivo do servidor FTP e escreve-o em um arquivo local (sem bloquear)
    • ftp_nb_fget() - Obtém um arquivo de um servidor FTP e escreve-o para um arquivo aberto(sem bloquear)

    add a note add a note

    User Contributed Notes 6 notes

    up
    6
    broom at alturnanetworks dot com
    15 years ago
    Another ftp_get_contents approach, using a temperary stream handler. Returns file contents as string.

    <?php
    function ftp_get_contents ($conn_id, $filename,
    //Create temp handler:
            $tempHandle = fopen('php://temp', 'r+');

    //Get file from FTP assuming that it exists:
            ftp_fget($conn_id, $tempHandle, $filename, FTP_ASCII, 0));

            //Getting detailed stats to check filesize:
            $fstats = fstat($tempHandle);

        return     fread($tempHandle, $fstats['size']);
    }
    ?>
    up
    4
    broom at alturnanetworks dot com
    15 years ago
    <?php
    /**
    * Function returns contents via FTP connection and returns it as string (right version...)
    */
    function ftp_get_contents ($conn_id, $filename) {
            //Create temp handler:
            $tempHandle = fopen('php://temp', 'r+');
       
            //Get file from FTP:
            if (@ftp_fget($conn_id, $tempHandle, $filename, FTP_ASCII, 0)) {
                rewind($tempHandle);
            return     stream_get_contents($tempHandle);
        } else {
            return     false;
        }
    }
    ?>
    up
    -1
    mike at eastghost dot com
    11 years ago
    You might need to use ftp_pasv() if you're behind a firewall and receiving odd timeouts, file creation but now local data saving, etc.
    up
    -2
    lionskape at gmail dot com
    7 years ago
    if you are using windows ftp-server with cp1251 encoding there are some troubles with russian "я" in filename\path.

    php use telnet to connect ftp-server and there are special symbol with code 255 in telnet protocol. You can try use ftp_raw($connection, 'OPTS UTF8 ON'); and work in utf-8 (if server provides it).

    P.S. sorry for my bad english
    up
    -2
    rodrigo-rocha at oi dot net dot br
    21 years ago
    If you suply only a filename to the second parameter of function the ftp_get will open a pointer to the local file creating it and write to it.It's ok if your server dont execute for to mutch time and you dont get too many files but if you do it too many times the pointers created by ftp_get will not be closed and will end your opened files capacity at your server making it to do not open any more files until you restart it.
    up
    -3
    justrafi at gmail dot com
    16 years ago
    I was in need to synchronize two folders on two separate servers, one is a Windows server, and the other is a Linux server. I created this short and sweet function to help me do this. PLEASE NOTICE: This will not copy folders, and probably will fail if remote folder contains anything else than files.

    function sync_folders($host, $port, $username, $password, $remote_dir, $local_dir, $passive_mode = true) {
        $conn_id = ftp_connect($host, $port);
        if (!$conn_id) return false; # fail to connect
        if (!ftp_login($conn_id, $username, $password)) { ftp_close($conn_id); return false; }  # fail to login
        ftp_pasv($conn_id, $passive_mode);
        if (!ftp_chdir($conn_id, $remote_dir)) { ftp_close($conn_id); return false; } # fail to change dir
        if (substr($local_dir, -1) != '/') $local_dir .= '/';

        $list = ftp_nlist($conn_id, '.');
        sort($list);
        foreach ($list as $file) {
            if (!file_exists($local_dir . $file)) {
                $is_copied = ftp_get($conn_id, $local_dir . $file, $file, FTP_BINARY);
            }
        }
        ftp_close($conn_id);
        return true;
    }
    add a note add a note
    To Top