is_dir

(PHP 4, PHP 5, PHP 7)

is_dirDiz 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 é um nome de arquivo relativo, irá ser verificado relativamente ao atual diretório. Se filename é um link simbólico ou hard link então o link será resolvido e validado. Se o safe mode estiver habilitado ou o open_basedir, podem ser aplicadas mais restrições.

Valor Retornado

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

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 irá imprimir:

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

Erros

Em caso de falha um E_WARNING será emitido.

Notas

Nota: Os resultados desta função são cacheados. Veja clearstatcache() para mais detalhes.

Dica

A partir do PHP 5.0.0, esta função também pode ser utilizada com alguns wrappers URL. Veja Protocolos e Wrappers suportados para uma lista de quais wrappers são suportados pela família de funções stat().

Veja Também

  • chdir() - Muda o diretório
  • dir() - Retorna uma instância da classe Diretório
  • opendir() - Abre um manipulador de diretório
  • is_file() - Informa se o arquivo é um arquivo comum
  • is_link() - Diz se o arquivo é um link simbólico (symbolic link)