ftp_nlist
(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_nlist — Retorna uma lista de arquivos em um diretório
Descrição
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ão | Descrição |
---|---|
8.1.0 |
O parâmetro ftp agora espera uma instância de FTP\Connection;
anteriormente, um resource era esperado.
|
Exemplos
Example #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() - Retorna uma lista detalhada de arquivos no diretório fornecido
- ftp_mlsd() - Retorna uma lista de arquivos no diretório fornecido