PHP 5.4.31 Released

ftp_fget

(PHP 4, PHP 5)

ftp_fget Lädt eine Datei vom FTP-Server und speichert sie in eine geöffnete Datei

Beschreibung

bool ftp_fget ( resource $ftp_stream , resource $handle , string $remote_file , int $mode [, int $resumepos = 0 ] )

ftp_fget() lädt das remote_file vom FTP-Server und schreibt es in die per Dateizeiger angegebene Datei.

Parameter-Liste

ftp_stream

Der Verbindungshandler der FTP-Verbindung.

handle

Ein geöffneter Dateizeiger, in den die Daten geschrieben werden sollen.

remote_file

Der Pfad zur Datei auf dem Server.

mode

Der Transfer-Modus. Muss entweder FTP_ASCII oder FTP_BINARY sein.

resumepos

Die Position in der entfernten Datei, ab der der Download beginnen soll.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Beispiele

Beispiel #1 ftp_fget()-Beispiel

<?php

// Pfad zur entfernten Datei
$remote_file 'somefile.txt';
$local_file 'localfile.txt';

// Öffne eine Datei zum Schreiben
$handle fopen($local_file'w');

// Verbindung aufbauen
$conn_id ftp_connect($ftp_server);

// Login mit Benutzername und Passwort
$login_result ftp_login($conn_id$ftp_user_name$ftp_user_pass);

// Versuche $remote_file zu laden und in $handle zu speichern
if (ftp_fget($conn_id$handle$remote_fileFTP_ASCII0)) {
 echo 
"Erfolgreich in $local_file geschrieben\n";
} else {
 echo 
"Download von $remote_file zu $local_file war nicht möglich\n";
}

// Verbindung und Verbindungshandler schließen
ftp_close($conn_id);
fclose($handle);
?>

Changelog

Version Beschreibung
4.3.0 resumepos wurde hinzugefügt.

Siehe auch

  • ftp_get() - Lädt eine Datei von einem FTP-Server herunter
  • ftp_nb_get() - Überträgt eine Datei von dem FTP-Server und speichert sie lokal (nicht blockierend)
  • ftp_nb_fget() - Lädt eine Datei vom FTP-Server und schreibt sie in eine lokale Datei (nicht-blockierend)

add a note add a note

User Contributed Notes 5 notes

up
1
rodrigo-rocha at oi dot net dot br
11 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
0
mike at eastghost dot com
1 year 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
0
broom at alturnanetworks dot com
5 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
-1
justrafi at gmail dot com
6 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;
}
up
-1
broom at alturnanetworks dot com
5 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;
    }
}
?>
To Top