English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Tutoriais básicos do PHP

Tutoriais avançados do PHP

PHP & MySQL

Manual de referência do PHP

Uso e exemplo da função readdir() do PHP

PHP Directory Referência Manual

A função readdir() lê itens do handle de diretório

Sintaxe

Sintaxe

string readdir ( resource $dir_handle );

Definição e uso

Ele retorna o nome do próximo arquivo no diretório. Os nomes dos arquivos são retornados na ordem armazenada no sistema de arquivos.

ParâmetroNúmero
1

Parâmetros e descrição

dir_handle(obrigatório)

Manejador de diretório do recurso, antes aberto por opendir()

Retorno

Retorna o nome do arquivo com sucesso, ou FALSE em caso de falha.

nome_do_arquivo: mohd.gif

Atenção: Esta função pode retornar o valor booleano FALSE, mas também pode retornar valores não booleanos equivalentes a FALSE. Por favor, leia a seção sobre Tipos Booleanos para mais informações. Deve-se usar o operador === para testar o retorno da função.

Por favor, note o estilo de verificação do retorno de readdir() no exemplo a seguir. Aqui é testado explicitamente se o valor retornado é completamente igual a FALSE (tanto no valor quanto no tipo - mais informações em operadores de comparação), caso contrário, qualquer item de diretório cujo nome é avaliado como FALSE fará com que o loop pare (por exemplo, um diretório chamado "0").
   Exemplo/$dir = opendir("/var/www
   images");
      while (($file = readdir($dir)) !== false) { /echo "nome_do_arquivo: " . $file . "<br"
   }
   >";
?>

closedir($dir);

Resultados de saída
nome_do_arquivo: .
nome_do_arquivo: ..
nome_do_arquivo: logo.gif

nome_do_arquivo: mohd.gif

Exemplo online

Listar todos os arquivos do diretório:

Por favor, note o estilo de verificação do retorno de readdir() no exemplo a seguir. Aqui é testado explicitamente se o valor retornado é completamente igual a FALSE (tanto no valor quanto no tipo - mais informações em operadores de comparação), caso contrário, qualquer item de diretório cujo nome é avaliado como FALSE fará com que o loop pare (por exemplo, um diretório chamado "0").
// <?php 4Atenção em-.0.02 RC
Antes não existia !== operador/if ($handle = opendir('/path/to
    echo "Manejador de diretório: $handle\n";
    echo "Arquivos:\n";
    /* Esta é uma maneira correta de percorrer um diretório */
    while (false !== ($file = readdir($handle))) {
        echo "\n$file";
    }
    /* Esta é uma maneira incorreta de percorrer um diretório */
    while ($file = readdir($handle)) {
        echo "\n$file";
    }
    closedir($handle);
}
?>

PHP Directory Referência Manual