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

Beschreibung

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

ftp_fget() lädt die Datei remote_filename vom FTP-Server und schreibt sie in die per Dateizeiger angegebene Datei.

Parameter-Liste

ftp: Eine FTP\Connection-Instanz.
stream: Der geöffnete Dateizeiger, in den die Daten geschrieben werden sollen.
remote_filename: Der Pfad zur Datei auf dem Server.
mode: Der Transfer-Modus. Muss entweder FTP_ASCII oder FTP_BINARY sein.
offset: Die Position in der entfernten Datei, ab der der Download beginnen soll.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version	Beschreibung
8.1.0	Der Parameter `ftp` erwartet nun eine FTP\Connection-Instanz; vorher wurde eine Ressource erwartet.
7.3.0	Der Parameter `mode` ist nun optional. Zuvor war er verpflichtend.

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
$ftp = ftp_connect($ftp_server);

// Login mit Benutzername und Passwort
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// Versuche, $remote_file zu laden und in $handle zu speichern
if (ftp_fget($ftp, $handle, $remote_file, FTP_ASCII, 0)) {
 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($ftp);
fclose($handle);
?>

Siehe auch

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