XOOPS Brasil

 

opendir

(PHP 4, PHP 5)

opendirAbre um manipulador de diretório

Descrição

resource opendir ( string $path [, resource $context ] )

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

Exemplo #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

Veja Também

  • is_dir() - Diz se o caminho é um diretório
  • readdir() - Lê os campos do manipulador do diretório
  • Dir