ftp_rawlist()

Die PHP-Funktion ftp_rawlist() verstehen

Die Funktion ftp_rawlist() ist eine integrierte PHP-Funktion, die eine detaillierte Verzeichnisauflistung auf einem FTP-Server zurückgibt. In diesem Artikel diskutieren wir die Funktion im Detail und bieten Ihnen einen umfassenden Leitfaden zur Verwendung in Ihren PHP-Projekten.

Was ist ftp_rawlist()?

Die Funktion ftp_rawlist() ist eine integrierte PHP-Funktion, die eine detaillierte Verzeichnisauflistung auf einem FTP-Server zurückgibt. Sie akzeptiert zwei erforderliche Parameter und einen optionalen Parameter:

1. ftp_stream: Das Verbindungsobjekt oder die Ressource, die von der Funktion ftp_connect() zurückgegeben wird.
2. directory: Das aufzulistende Verzeichnis.
3. recursive (optional): Auf true setzen, um Unterverzeichnisse rekursiv aufzulisten.

Die Funktion gibt bei Erfolg ein Array von Strings zurück, das die detaillierte Verzeichnisauflistung enthält. Andernfalls wird false zurückgegeben. Beachten Sie, dass das zurückgegebene Array die Rohausgabe des FTP-Befehls LIST enthält, die je nach Betriebssystem und Konfiguration des Servers variiert. Im Gegensatz zu ftp_nlist(), das ein einfaches Array von Dateinamen zurückgibt, liefert ftp_rawlist() die vollständige Rohausgabe, einschließlich Berechtigungen, Eigentumsverhältnissen und Dateigrößen.

Syntax von ftp_rawlist()

Die Syntax der Funktion ftp_rawlist() lautet wie folgt:

Syntax von ftp_rawlist()

array ftp_rawlist ( FTP\Connection|resource $ftp_stream , string $directory [, bool $recursive = false ] )

Die Funktion ftp_rawlist() benötigt zwei erforderliche Parameter, ftp_stream und directory. Der Parameter ftp_stream ist die Verbindungs-ID, die von der Funktion ftp_connect() zurückgegeben wird, und der Parameter directory ist das aufzulistende Verzeichnis. Die Funktion verfügt außerdem über einen optionalen Parameter recursive, mit dem Sie angeben können, ob Unterverzeichnisse aufgelistet werden sollen.

Verwendung von ftp_rawlist()

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

Verwendung von ftp_rawlist()

<‌?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.");
}

// Get a detailed listing of the directory
$listing = ftp_rawlist($conn, '/public_html');

// Output the listing to the console
if ($listing) {
    foreach ($listing as $item) {
        echo $item . "\n";
    }
}

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

In diesem Beispiel stellen wir eine Verbindung zum FTP-Server mit der Funktion ftp_connect() her und prüfen, ob sie erfolgreich war. Anschließend melden wir uns mit unseren FTP-Zugangsdaten über die Funktion ftp_login() an und verifizieren die Anmeldung. Wir erhalten eine detaillierte Verzeichnisauflistung mit der Funktion ftp_rawlist() und geben diese auf der Konsole aus. Abschließend schließen wir die FTP-Verbindung mit der Funktion ftp_close().

Sicherheitshinweis: Standard-FTP überträgt Zugangsdaten und Daten im Klartext. Für Produktionsumgebungen sollten Sie ftp_ssl_connect() für explizites FTP über TLS verwenden oder auf SFTP (über die Erweiterung ssh2) für verschlüsselte Übertragungen umsteigen.

Fehlerbehandlung in ftp_rawlist()

Es ist wichtig, Fehler bei der Verwendung der Funktion ftp_rawlist() ordnungsgemäß zu behandeln. Wenn die Funktion false zurückgibt, bedeutet dies, dass der Vorgang nicht erfolgreich war. Hier ist ein Beispiel für die Fehlerbehandlung:

Fehlerbehandlung in ftp_rawlist()

<‌?php

// Assuming $conn is an active FTP connection
$listing = ftp_rawlist($conn, '/public_html');

if (!$listing) {
    echo "Failed to get directory listing from FTP server.\n";
}

ftp_close($conn);
?>

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

Fazit

Zusammenfassend lässt sich sagen, dass die Funktion ftp_rawlist() ein nützliches Werkzeug zum Abrufen einer detaillierten Verzeichnisauflistung auf einem FTP-Server ist. Bei ordnungsgemäßer Verwendung und Fehlerbehandlung kann diese Funktion ein wertvolles Hilfsmittel in Ihren PHP-Projekten sein.

Practice

Welche Funktion hat ftp_rawlist in PHP?

Es gibt eine Liste von Dateien in einem angegebenen Verzeichnis aus.Es gibt Informationen über eine Datei auf einem Server.Es gibt eine detaillierte Liste von Dateien im angegebenen Verzeichnis auf einem FTP-Server zurück.Es ruft den Inhalt einer Datei von einem Server ab.