ftp_fget

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

ftp_fget 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

VersionBeschreibung
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)
To Top