Funções PHP |
. Glossários Funções PHP - dir ( ) |
dir -- classe diretório
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:
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.