is_dir

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

    is_dir — Diz se o caminho é um diretório

    Descrição

    is_dir(string$filename): bool

    Informa se o dado nome de arquivo é um diretório.

    Parâmetros

    filename

    Caminho para o arquivo. Se filename for um nome de arquivo relativo, será verificado relativamente ao diretório atual de trabalho. Se filename for uma ligação simbólica ou ligação rígida então a ligação será resolvida e validado. Se open_basedir estiver habilitado restrições adicionais podem ser aplicáveis.

    Valor Retornado

    Retorna true se o nome do arquivo existe e é um diretório, false caso contrário.

    Erros/Exceções

    Em caso de falha, um E_WARNING será emitido.

    Exemplos

    Exemplo #1 Exemplo da is_dir()

    <?php
    var_dump    (is_dir('a_file.txt'));
    var_dump(is_dir('bogus_dir/abc'));

    var_dump(is_dir('..')); // um diretório acima
    ?>

    O exemplo acima produzirá:

    bool(false) bool(false) bool(true)

    Notas

    Nota: Os resultados desta função são armazenados em cache. Consulte a função clearstatcache() para mais detalhes.

    Dica

    A partir do PHP 5.0.0, esta função também pode ser usada com alguns wrappers URL. Consulte os Protocolos e Wrappers suportados para determinar quais wrappers suportam a família de funções stat().

    Veja Também

    • chdir() - Muda o diretório
    • dir() - Retorna uma instância da classe Directory
    • opendir() - Abre um manipulador de diretório
    • is_file() - Informa se o arquivo é um arquivo comum
    • is_link() - Informa se o arquivo é uma ligação simbólica
    To Top