PHP 8.1.0 Alpha 1 available for testing


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

ftp_fgetDownloads a file from the FTP server and saves to an open file


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

ftp_fget() retrieves remote_filename from the FTP server, and writes it to the given file pointer.



The link identifier of the FTP connection.


An open file pointer in which we store the data.


The remote file path.


The transfer mode. Must be either FTP_ASCII or FTP_BINARY.


The position in the remote file to start downloading from.

Return Values

Returns true on success or false on failure.


Version Description
7.3.0 The mode parameter is now optional. Formerly it has been mandatory.


Example #1 ftp_fget() example


// 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_fileFTP_ASCII0)) {
"successfully written to $local_file\n";
} else {
"There was a problem while downloading $remote_file to $local_file\n";

// close the connection and the file handler

See Also

  • ftp_get() - Downloads a file from the FTP server
  • ftp_nb_get() - Retrieves a file from the FTP server and writes it to a local file (non-blocking)
  • ftp_nb_fget() - Retrieves a file from the FTP server and writes it to an open file (non-blocking)

add a note add a note

User Contributed Notes 6 notes

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

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

fread($tempHandle, $fstats['size']);
broom at alturnanetworks dot com
12 years ago
* 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)) {
    } else {
mike at eastghost dot com
8 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.
lionskape at gmail dot com
4 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
rodrigo-rocha at oi dot net dot br
18 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.
justrafi at gmail dot com
13 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, '.');
    foreach ($list as $file) {
        if (!file_exists($local_dir . $file)) {
            $is_copied = ftp_get($conn_id, $local_dir . $file, $file, FTP_BINARY);
    return true;
To Top