Retourne la liste des fichiers d'un dossier

# ftp_nlist

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

ftp_nlist — Retourne la liste des fichiers d'un dossier

### Description

function 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é

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open