ftp_nb_put
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ftp_nb_put — Lädt eine Datei auf den FTP-Server (nicht-blockierend)
Beschreibung
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_ASCIIoderFTP_BINARYsein. -
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
