opendir
(PHP 4, PHP 5)
opendir — Abre um manipulador de diretório
Descrição
Abre um manipulador de diretório para ser usado em chamadas subsequentes a closedir(), readdir(), e rewinddir().
Parâmetros
- path
-
O caminho do diretório a ser aberto
- context
-
Para descrição do parâmetro context , consulte a seção sobre streams do manual.
Valor Retornado
Retorna um manipulador de diretório resource em sucesso, ou FALSE em falha.
Se path não é um diretório válido ou se o diretório não pode ser aberto devi a restrições de permissões ou ainda por erro no sistema de arquivos, opendir() retorna FALSE e gera um erro PHP de nível E_WARNING. Você pode suprimir a exibição da mensagem de erro de opendir() acrecentando um '@' na frente do nome da função.
Histórico
| Versão | Descrição |
|---|---|
| 5.0.0 | path suporta ftp:// URL wrapper. |
| 4.3.0 | path pode também ser uma URL que suporte listagem de diretório, contudo somente o file:// URL wrapper suporta isto no PHP 4 |
Exemplos
Example#1 exemplo de opendir()
<?php
$dir = "/etc/php5/";
// Abre um diretorio conhecido, e faz a leitura de seu conteudo
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
while (($file = readdir($dh)) !== false) {
echo "filename: $file : filetype: " . filetype($dir . $file) . "\n";
}
closedir($dh);
}
}
?>
O exemplo acima irá imprimir algo similar a:
filename: . : filetype: dir filename: .. : filetype: dir filename: apache : filetype: dir filename: cgi : filetype: dir filename: cli : filetype: dir