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

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

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

Tip

A partir do PHP 5.0.0, esta função também pode ser usada com alguns wrappers URL. Consulte os Protocolos e empacotadores 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