opendir

(PHP 4, PHP 5, PHP 7, PHP 8)

opendirAbre um manipulador de diretório

Descrição

opendir(string$directory, ?resource$context = null): resource|false

Abre um manipulador de diretório para ser usado em chamadas subsequentes de closedir(), readdir() e rewinddir().

Parâmetros

directory

O caminho do diretório a ser aberto

context

Para descrição do parâmetro context, consulte a seção sobre fluxos do manual.

Valor Retornado

Retorna um manipulador de diretório do tipo resource em caso de sucesso, ou false em caso de falha

Erros/Exceções

Em caso de falha, um E_WARNING será emitido.

Isto pode ocorrer se directory não for um nome de diretório válido, o diretório não puder ser aberto por restrições de permissão, ou por erros no sistema de arquivos.

Registro de Alterações

VersãoDescrição
8.0.0context agora pode ser nulo.

Exemplos

Exemplo #1 Exemplo de opendir()

<?php
$dir
= "/etc/php5/";

// Abre um diretório existente, e faz a leitura de seu conteúdo
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 produzirá algo semelhante 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ê entrada do manipulador do diretório
  • dir() - Retorna uma instância da classe Directory
To Top