ftp_nlist

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_nlist Liefert eine Liste der im angegebenen Verzeichnis enthaltenen Dateien

Beschreibung

ftp_nlist(FTP\Connection$ftp, string$directory): array|false

Parameter-Liste

ftp

Eine FTP\Connection-Instanz.

directory

Das Verzeichnis, das aufgelistet werden soll. Dieser Parameter kann auch Argumente enthalten, z. B. ftp_nlist($ftp, "-la /your/dir");. Zu beachten ist, dass dieser Parameter nicht maskiert ist und dass deswegen Probleme bei Dateinamen mit Leerzeichen oder anderen Zeichen auftreten können.

Rückgabewerte

Gibt bei Erfolg ein Array von Dateinamen aus dem angegebenen Verzeichnis zurück oder false im Fehlerfall.

Changelog

VersionBeschreibung
8.1.0 Der Parameter ftp erwartet nun eine FTP\Connection-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 ftp_nlist()-Beispiel

<?php

// Verbindung aufbauen
$ftp = ftp_connect($ftp_server);

// Login mit Benutzername und Passwort
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// Inhalt des aktuellen Verzeichnisses auslesen
$contents = ftp_nlist($ftp, ".");

// Ausgabe von $contents
var_dump($contents);

?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

array(3) { [0]=> string(11) "public_html" [1]=> string(10) "public_ftp" [2]=> string(3) "www"

Siehe auch

  • ftp_rawlist() - Liefert eine detaillierte Liste der Dateien im angegebenen Verzeichnis
  • ftp_mlsd() - Liefert eine Liste der Dateien im angegebenen Verzeichnis
To Top