Lädt eine Datei auf den FTP-Server (nicht-blockierend)

Beschreibung

ftp_nb_put(
    FTP\Connection $ftp,
    string $remote_filename,
    string $local_filename,
    int $mode = FTP_BINARY,
    int $offset = 0
): int|false

ftp_nb_put() speichert eine lokale Datei auf dem FTP-Server.

Der Unterschied zwischen dieser Funktion und ftp_put() ist, dass diese Funktion die Datei asynchron hochlädt, sodass Ihr Programm noch andere Operationen durchführen kann, während die Datei hochgeladen wird.

Parameter-Liste

ftp: Eine FTP\Connection-Instanz.
remote_filename: Der Pfad zur Datei auf dem Server.
local_filename: Der Pfad zur lokalen Datei.
mode: Der Transfer-Modus. Muss entweder FTP_ASCII oder FTP_BINARY sein.
offset: Die Startposition für den Upload in der Datei auf dem Server.

Rückgabewerte

Gibt FTP_FAILED, FTP_FINISHED oder FTP_MOREDATA zurück, oder false, wenn die lokale Datei nicht geöffnet werden kann.

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_nb_put()-Beispiel

<?php

// Initialisiere den Upload
$ret = ftp_nb_put($ftp, "test.remote", "test.local", FTP_BINARY);
while ($ret == FTP_MOREDATA) {

   // Irgendwas machen
   echo ".";

   // Upload fortsetzen
   $ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
   echo "Beim Transfer trat ein Fehler auf";
   exit(1);
}
?>

Beispiel #2 Einen Upload mit ftp_nb_put() wieder aufnehmen

<?php

// Initialisieren
$ret = ftp_nb_put($ftp, "test.remote", "test.local",
                      FTP_BINARY, ftp_size("test.remote"));
// ODER: $ret = ftp_nb_put($ftp, "test.remote", "test.local",
//                           FTP_BINARY, FTP_AUTORESUME);


while ($ret == FTP_MOREDATA) {

   // Irgendwas machen
   echo ".";

   // Upload fortsetzen
   $ret = ftp_nb_continue($ftp);
}
if ($ret != FTP_FINISHED) {
   echo "Beim Transfer trat ein Fehler auf";
   exit(1);
}
?>

Siehe auch

ftp_nb_fput() - Lädt eine geöffnete Datei auf den FTP-Server (nicht blockierend)
ftp_nb_continue() - Nimmt die Übertragung einer Datei wieder auf (nicht-blockierend)
ftp_put() - Lädt eine Datei auf einen FTP-Server
ftp_fput() - Überträgt eine geöffnete Datei auf einen FTP-Server