ftp_nb_put

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

ftp_nb_putLä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

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_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
To Top