ftp_nb_put()

Die PHP-Funktion ftp_nb_put() verstehen

Die Funktion ftp\_nb\_put() ist eine integrierte PHP-Funktion, die eine Datei im nicht-blockierenden Modus auf einen FTP-Server hochlädt. Dieser Leitfaden behandelt die Parameter, die Syntax, die Verwendung und die Fehlerbehandlung, um Ihnen zu helfen, sie effektiv in Ihre PHP-Projekte zu integrieren.

Was ist ftp_nb_put()?

Die Funktion ftp\_nb\_put() lädt eine Datei auf einen FTP-Server hoch, ohne die Skriptausführung zu unterbrechen. Sie akzeptiert drei erforderliche Parameter:

1. ftp_stream: Die Verbindungs-ID, die von ftp_connect() zurückgegeben wird (ein FTP\Connection-Objekt in PHP 7.1+).
2. remote_file: Der entfernte Dateipfad, auf den die Datei hochgeladen wird.
3. local_file: Der lokale Dateipfad.

Die Funktion gibt eine der folgenden Konstanten zurück: FTP_MOREDATA (Übertragung läuft), FTP_FINISHED (Übertragung abgeschlossen) oder FTP_FAILED (Fehler aufgetreten).

Syntax von ftp_nb_put()

Die Syntax der ftp_nb_put() Funktion lautet wie folgt:

Syntax von ftp_nb_put()

int ftp_nb_put ( FTP\Connection $ftp_stream , string $remote_file , string $local_file , int $mode [, int $startpos = 0 ] )

Die Funktion ftp\_nb\_put() benötigt drei erforderliche Parameter (ftp_stream, remote_file und local_file) sowie einen optionalen Parameter (startpos). Der Parameter mode ist erforderlich und gibt den Übertragungsmodus an: FTP_BINARY wird für die meisten Dateien (Bilder, Archive, ausführbare Dateien) empfohlen, um die Beschädigung von Zeilenumbrüchen zu verhindern, während FTP_ASCII für reine Textdateien verwendet wird (obwohl FTP_BINARY im Allgemeinen für alle Dateitypen sicherer ist). Der Parameter startpos gibt die Position in der entfernten Datei an, an der der Upload beginnen soll. Standardmäßig ist startpos auf 0 gesetzt, was bedeutet, dass der Upload am Anfang der Datei beginnt.

Verwendung von ftp_nb_put()

Um die ftp_nb_put() Funktion zu verwenden, müssen Sie zunächst eine Verbindung zum FTP-Server mit der ftp_connect() Funktion herstellen. Hier ist ein Beispiel:

Verwendung von ftp_nb_put()

<‌?php

// Set up an FTP connection
$conn = ftp_connect('ftp.example.com');
if (!$conn) {
    die('Could not connect to FTP server.');
}

// Login with your FTP credentials
if (!ftp_login($conn, 'username', 'password')) {
    die('Login failed.');
}

// Initiate an asynchronous FTP operation
$result = ftp_nb_put($conn, 'remote_file.txt', 'local_file.txt', FTP_BINARY);
if ($result === FTP_FAILED) {
    die('Upload failed.');
}

// Continue the asynchronous FTP operation
while ($result === FTP_MOREDATA) {
    // Do something else while waiting for the FTP operation to complete
    $result = ftp_nb_continue($conn);
}

if ($result === FTP_FINISHED) {
    echo "Upload completed successfully.\n";
}

// Close the FTP connection
ftp_close($conn);

In diesem Beispiel stellen wir eine Verbindung zum FTP-Server mit der Funktion ftp_connect() her. Anschließend melden wir uns mit unseren FTP-Zugangsdaten über die Funktion ftp_login() an. Wir starten eine asynchrone FTP-Operation mit der Funktion ftp_nb_put(). Wir setzen die Operation mit der Funktion ftp_nb_continue() innerhalb einer Schleife fort, die auf FTP_MOREDATA prüft, und überprüfen schließlich die Fertigstellung mit FTP_FINISHED, bevor wir die FTP-Verbindung schließen.

Fehlerbehandlung in ftp_nb_put()

Es ist wichtig, Fehler bei der Verwendung der ftp_nb_put() Funktion ordnungsgemäß zu behandeln. Wenn die Funktion FTP_FAILED zurückgibt, bedeutet dies, dass der Upload fehlgeschlagen ist. Hier ist ein Beispiel, wie Fehler behandelt werden können:

Fehlerbehandlung in ftp_nb_put()

<‌?php

$result = ftp_nb_put($conn, 'remote_file.txt', 'local_file.txt', FTP_BINARY);

if ($result === FTP_FAILED) {
    echo "Failed to upload file to remote server.\n";
}

while ($result === FTP_MOREDATA) {
    // Do something else while waiting for the FTP operation to complete
    $result = ftp_nb_continue($conn);
}

if ($result === FTP_FINISHED) {
    echo "Upload completed.\n";
}

ftp_close($conn);

Durch die angemessene Fehlerbehandlung und Überprüfung des Rückgabewerts der Funktion können Sie den Erfolg Ihrer FTP-Operationen mit der ftp_nb_put() Funktion sicherstellen.

Fazit

Zusammenfassend lässt sich sagen, dass die ftp_nb_put() Funktion ein nützliches Werkzeug zum Hochladen von Dateien auf einen FTP-Server im nicht-blockierenden Modus ist. Sie ermöglicht es Ihnen, mit anderen Operationen fortzufahren, während Sie auf den Abschluss des Uploads warten. Bei korrekter Verwendung und Fehlerbehandlung kann diese Funktion ein wertvolles Hilfsmittel in Ihren PHP-Projekten sein.

Hinweis: Die ftp_nb_* Funktionen gelten in modernem PHP als veraltet. Für neue Projekte sollten Sie cURL oder asynchrone HTTP-Bibliotheken wie Guzzle für bessere Leistung, Sicherheit und breitere Protokollunterstützung in Betracht ziehen.

Praxis

Was ist der Zweck der ftp_nb_put-Funktion in PHP?

Sie sendet eine Datei im nicht-blockierenden Modus an den FTP-Server.Sie ruft eine Datei vom FTP-Server ab.Sie löscht eine Datei vom FTP-Server.Sie startet den Download einer Datei von einem FTP-Server.Sie ermöglicht die Fortsetzung der Datenübertragung jederzeit.