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

    VersionDescription
    8.1.0 La paramètre ftp attend désormais une instance de FTP\Connection ; auparavant, une ressource é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é
    To Top