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ão Descrição
8.0.0 context agora pode ser nulo.

Exemplos

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