ftp_nlist

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

ftp_nlist — Retourne la liste des fichiers d'un dossier

Description

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

Liste de paramètres

ftp: Une instance de FTP\Connection.
directory: Le dossier à lister. Ce paramètre peut également inclure des arguments, p. ex. ftp_nlist($ftp, "-la /your/dir"); Il est à noter que ce paramètre n'est pas échappé, il peut donc y avoir des comportements non-désirés si le nom des fichiers contient des espaces ou d'autres caractères.

Valeurs de retour

Retourne un tableau de noms de fichiers présents dans le dossier spécifié en cas de succès ou false si une erreur survient.

Historique

Version	Description
8.1.0	La paramètre `ftp` attend désormais une instance de FTP\Connection ; auparavant, une resource était attendu.

Exemples

Exemple #1 Exemple avec ftp_nlist()

<?php

// Mise en place d'une connexion basique
$ftp = ftp_connect($ftp_server);

// Identification avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// Récupération du contenu d'un dossier
$contents = ftp_nlist($ftp, ".");

// Affichage de $contents
var_dump($contents);

?>

Résultat de l'exemple ci-dessus est similaire à :

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

Voir aussi

ftp_rawlist() - Fait une liste détaillée des fichiers d'un dossier
ftp_mlsd() - Retourne la liste des fichiers d'un dossier donné