opendir
rewinddir
Funções de Diretórios
PHP Manual

# readdir

(PHP 4, PHP 5)

readdir — Lê os campos do manipulador do diretório

### Descrição

string readdir ( resource `$dir_handle` )

Retorna o nome de arquivo do próximo arquivo do diretório. Os nomes de arquivos são retornados na ordem informada pelo sistema de arquivos.

### Parâmetros

`dir_handle`

  O manipulador de diretório resource previamente aberto com opendir().

### Valor Retornado

Retorna o nome do arquivo em sucesso, ou `FALSE` em falha.

Aviso

Esta função pode retornar o booleano `FALSE`, mas também pode retornar um valor não-booleano que pode ser avaliado como `FALSE`, como 0 ou "". Leia a seção em Booleanos para maiores informações. Utilize o operador === para testar o valor retornado por esta função.

### Exemplos

Exemplo #1 Listando todos os arquivos de um diretório

Verifique cuidadosamente o estilo de checagem dos valores retornados por readdir() nos exemplos abaixo. Nós explicitamente testamos se o valor retornado é idêntico a (igual e do mesmo tipo que `FALSE` --- veja Operadores de Comparação para maiores detalhes). De outra forma, qualquer entrada de diretório que seja avaliada para `FALSE` irá parar o loop (por exemplo, um diretório nomeado "0").

`<?php
// Note que !== não existia antes do PHP 4.0.0-RC2
if ($handle = opendir('/path/to/files')) {
echo "Manipulador de diretório: $handle\n";
echo "Arquivos:\n";
/* Esta é a forma correta de varrer o diretório */
while (false !== ($file = readdir($handle))) {
echo "$file\n";
}
/* Esta é a forma INCORRETA de varrer o diretório */
while ($file = readdir($handle)) {
echo "$file\n";
}
closedir($handle);
}
?>`

Exemplo #2 Listar todos os arquivos no diretório atual e retirar . e ..

`<?php
if ($handle = opendir('.')) {
while (false !== ($file = readdir($handle))) {
if ($file != "." && $file != "..") {
echo "$file\n";
}
}
closedir($handle);
}
?>`

### Veja Também

- is_dir() - Diz se o caminho é um diretório
- glob() - Acha caminhos que combinam com um padrão

opendir
rewinddir
Funções de Diretórios
PHP Manual