ftp_nb_put

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

ftp_nb_putSpeichert eine Datei auf dem FTP-Server (nicht-blockierend)

Beschreibung

ftp_nb_put ( resource $ftp_stream , string $remote_file , string $local_file [, int $mode = FTP_IMAGE [, int $startpos = 0 ]] ) : int

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

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

Parameter-Liste

ftp_stream

Der Verbindungshandler der FTP-Verbindung.

remote_file

Der Pfad zur Datei auf dem Server.

local_file

Der Pfad zur lokalen Datei.

mode

Der Transfer-Modus. Muss entweder FTP_ASCII oder FTP_BINARY sein.

startpos

Die Startposition für den Upload in der entfernten Datei.

Rückgabewerte

Gibt FTP_FAILED oder FTP_FINISHED oder FTP_MOREDATA zurück.

Changelog

Version Beschreibung
7.3.0 Der mode Parameter ist nun optional. Zuvor war er verpflichtend.

Beispiele

Beispiel #1 ftp_nb_put()-Beispiel

<?php

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

   
// Irgendwas machen
   
echo ".";

   
// Upload fortsetzen
   
$ret ftp_nb_continue($my_connection);
}
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($my_connection"test.remote""test.local",
                      
FTP_BINARYftp_size("test.remote"));
// ODER: $ret = ftp_nb_put($my_connection, "test.remote", "test.local",
// FTP_BINARY, FTP_AUTORESUME);


while ($ret == FTP_MOREDATA) {

   
// Irgendwas machen
   
echo ".";

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

Siehe auch

  • ftp_nb_fput() - Speichert 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