dir

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

    dir — Retorna uma instância da classe Directory

    Descrição

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

    Um mecanismo pseudo-orientado a objeto para ler um diretório. O diretório fornecido pelo parâmetro directory é aberto.

    Parâmetros

    directory

    Diretório a ser aberto

    context

    Um resource de contexto de stream.

    Valor Retornado

    Retorna uma instância de Directory, ou false em caso de erro.

    Registro de Alterações

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

    Exemplos

    Exemplo #1 Exemplo da dir()

    Repare nos detalhes de como o valor retornado de Directory::read() é verificado no exemplo abaixo. É testado explicitamente se o valor de retorno é idêntico a (igual e do mesmo tipo que - consulte operadores de comparação para mais informação) false, caso contrário, qualquer entrada de diretório cujo nome seja interpretado como false fará parar o loop.

    <?php
    $d     = dir("/etc/php5");
    echo     "Handle: " . $d->handle . "\n";
    echo     "Caminho: " . $d->path . "\n";
    while (    false !== ($entry = $d->read())) {
    echo     $entry."\n";
    }
    $d->close();
    ?>

    O exemplo acima produzirá algo semelhante a:

    Handle: Resource id #2 Caminho: /etc/php5 . .. apache cgi cli

    Notas

    Nota:

    A ordem em que as entradas do diretório são retornadas pelo método de leitura é dependente do sistema operacional.

    To Top