# 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, e.g. `ftp_nlist($ftp, "-la /your/dir");` Notez 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 nom de fichiers présent 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é