Funções para Sistema de arquivo
PHP Manual

file_exists

(PHP 4, PHP 5)

file_existsCheca se um arquivo ou diretório existe

Descrição

bool file_exists ( string $filename )

Verifica se um arquivo ou diretório existe.

Parâmetros

filename

Caminho para o arquivo ou diretório.

No Windows, use //computername/share/filename ou \\\\computername\share\filename para checar arquivos em compartilhamentos de rede.

Valor Retornado

Retorna TRUE se o arquivo ou diretório especificado por filename existe; FALSE caso contrário.

Nota:

Esta função retornará FALSE para links simbólicos apontando para arquivos inexistentes.

Aviso

Esta função retorna FALSE para arquivos inacessíveis devido à restrições do safe mode. Contudo, estes arquivos ainda podem ser incluídos se eles estão localizado no safe_mode_include_dir.

Nota:

A verificação é feita usando o real UID/GID ao invés do efetivo.

Exemplos

Exemplo #1 Testando se um arquivo existe

<?php
$filename 
'/caminho/para/qualquer.txt';

if (
file_exists($filename)) {
    echo 
"O arquivo $filename existe";
} else {
    echo 
"O arquivo $filename não existe";
}
?>

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 Supported Protocols and Wrappers para uma lista de quais wrappers são suportados pela família de funções stat().

Veja Também


Funções para Sistema de arquivo
PHP Manual