Retorna uma lista detalhada de arquivos no diretório fornecido

Descrição

ftp_rawlist(FTP\Connection $ftp, string $directory, bool $recursive = false): array|false

ftp_rawlist() executa o comando FTP LIST e retorna o resultado como um array.

Parâmetros

ftp: Uma instância de FTP\Connection.
directory: O caminho do diretório. Pode incluir argumentos para o comando LIST.
recursive: Se definido como true, o comando emitido será LIST -R.

Valor Retornado

Retorna um array onde cada elemento corresponde a uma linha de texto. Retorna false quando o diretório informado em directory for inválido.

A saída não é analisada de forma alguma. O identificador do tipo de sistema retornado por ftp_systype() pode ser usado para determinar como os resultados devem ser interpretados.

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_rawlist()

<?php

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

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

// obtém a lista de arquivos para /
$buff = ftp_rawlist($ftp, '/');

// fecha a conexão
ftp_close($ftp);

// exibe o buffer
var_dump($buff);
?>

O exemplo acima produzirá algo semelhante a:

array(3) {
  [0]=>
  string(65) "drwxr-x---   3 vincent  vincent      4096 Jul 12 12:16 public_ftp"
  [1]=>
  string(66) "drwxr-x---  15 vincent  vincent      4096 Nov  3 21:31 public_html"
  [2]=>
  string(73) "lrwxrwxrwx   1 vincent  vincent        11 Jul 12 12:16 www -> public_html"
}

Veja Também

ftp_nlist() - Retorna uma lista de arquivos em um diretório
ftp_mlsd() - Retorna uma lista de arquivos no diretório fornecido