(PHP 4, PHP 5, PHP 7)
file_exists — Verifica se um arquivo ou diretório existe
$filename
) : boolVerifica se um arquivo ou diretório existe.
filenameCaminho para o arquivo ou diretório.
No Windows, use //computername/share/filename ou \\computername\share\filename para checar arquivos em compartilhamentos de rede.
Retorna TRUE se o arquivo ou diretório especificado por
filename existe; FALSE caso contrário.
Nota:
Esta função retornará
FALSEpara links simbólicos apontando para arquivos inexistentes.
Esta função retorna FALSE para arquivos inacessíveis devido à restrições de 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 UID/GID real ao invés do efetivo.
Nota: Por conta do tipo inteiro do PHP ser sinalizado em muitas plataformas de 32bits, algumas funções de arquivos podem retornar resultados inesperados para arquivos maiores que 2GB.
Exemplo #1 Testando se um arquivo existe
<?php
$filename = '/caminho/para/arquivo.txt';
if (file_exists($filename)) {
echo "O arquivo $filename existe";
} else {
echo "O arquivo $filename não existe";
}
?>
Em caso de falha um E_WARNING será emitido.
Nota: Os resultados desta função são cacheados. Veja clearstatcache() para mais detalhes.
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().