Manual do PHP
Anterior |  | Próxima

# dir

dir -- classe diretório

## Descrição

class dir {
dir ( string directory )
string path
resource handle
string read ( void )
void rewind ( void )
void close ( void )
}

Um mecanismo pseudo-orientado a objeto para ler um diretório. O parâmetro dado directory é aberto. Duas propriedades são disponíveis uma vez que o diretório foi aberto: A propriedade handle pode ser usada com outras funções de diretório como readdir(), rewinddir() e closedir(). A propriedade path é configurada para o caminho que o diretório foi aberto. Três métodos disponibilizados são: read, rewind e close.

Repare nos detalhes de como o valor retornado de dir() é verificado no exemplo abaixo. Nós explicitamente testamos se valor de retorno é idêntico (igual e do mesmo tipo que --- veja operadores de comparação para mais detalhes) a `FALSE`, desde que, de outra forma, qualquer entrada de diretório que seja avaliada para `FALSE` fará parar o loop.

Exemplo 1. Exemplo dir()

`<?php $d = dir("/etc"); echo "Manipulador: ".$d->handle."<br>\n"; echo "Caminho: ".$d->path."<br>\n"; while (false !== ($entry = $d->read())) { echo $entry."<br>\n"; } $d->close(); ?>`

> Nota: A ordem em que os diretórios são retornadas pelo método é dependente do sistema.

> Nota: Este módulo define a classe interna Directory, significando que você não será capaz de criar uma classe sua com esse nome. Para uma lista completa das classes predefinidas no PHP, veja em Classes Predefinidas.

Anterior | Principal | Próxima
chroot | Acima | closedir