ftp_nlist
(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_nlist — Liefert eine Liste der im angegebenen Verzeichnis enthaltenen Dateien
Beschreibung
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
Version | Beschreibung |
---|---|
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