ftp_nb_fput
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
ftp_nb_fput — Lädt eine geöffnete Datei auf den FTP-Server (nicht blockierend)
Beschreibung
FTP\Connection
$ftp,string
$remote_filename,resource
$stream,int
$mode = FTP_BINARY,int
$offset = 0): int
ftp_nb_fput() lädt Datei von einem Dateizeiger in eine Datei auf einem FTP-Server.
Der Unterschied zwischen dieser Funktion und ftp_fput() ist, dass diese Funktion die Datei asynchron hochlädt, sodass Ihr Programm noch andere Operationen ausführen kann, während die Datei hochgeladen wird.
Parameter-Liste
-
ftp -
Eine FTP\Connection-Instanz.
-
remote_filename -
Der Pfad zur Datei auf dem Server.
-
stream -
Ein geöffneter Dateizeiger zu einer lokalen Datei. Das Lesen wird am Dateiende beendet.
-
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.
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_fput()-Beispiel
<?php
$file = 'index.php';
$fp = fopen($file, 'r');
$ftp = ftp_connect($ftp_server);
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// Upload initiieren
$ret = ftp_nb_fput($ftp, $file, $fp, 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);
}
fclose($fp);
?>
Siehe auch
- ftp_nb_put() - Lädt eine 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
