array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ftp-nlist.php', 1 => 'ftp_nlist', 2 => 'Liefert eine Liste der im angegebenen Verzeichnis enthaltenen Dateien', ), 'up' => array ( 0 => 'ref.ftp.php', 1 => 'FTP-Funktionen', ), 'prev' => array ( 0 => 'function.ftp-nb-put.php', 1 => 'ftp_nb_put', ), 'next' => array ( 0 => 'function.ftp-pasv.php', 1 => 'ftp_pasv', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/ftp/functions/ftp-nlist.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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