ftp_nlist

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

    ftp_nlist — Retorna uma lista de arquivos em um diretório

    Descrição

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

    Parâmetros

    ftp

    Uma instância de FTP\Connection.

    directory

    O diretório a ser listado. Este parâmetro também pode incluir argumentos, ex.: ftp_nlist($ftp, "-la /your/dir");. Note que este parâmetro não é escapado, portanto pode haver alguns problemas com nomes de arquivo contendo espaços e outros caracteres.

    Valor Retornado

    Retorna um array com os nomes dos arquivos do diretório especificado em caso de sucesso, ou false em caso de erro.

    Registro de Alterações

    VersãoDescrição
    8.1.0 O parâmetro ftp agora espera uma instância de FTP\Connection; anteriormente, um resource era esperado.

    Exemplos

    Exemplo #1 Exemplo de ftp_nlist()

    <?php

    // define uma conexão básica
    $ftp = ftp_connect($ftp_server);

    // login com usuário e senha
    $login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

    // obtém o conteúdo do diretório atual
    $contents = ftp_nlist($ftp, ".");

    // mostra $contents
    var_dump($contents);

    ?>

    O exemplo acima produzirá algo semelhante a:

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

    Veja Também

    • ftp_rawlist() - Returns a detailed list of files in the given directory
    • ftp_mlsd() - Returns a list of files in the given directory
    To Top