file_exists
(PHP 4, PHP 5)
file_exists — Checa se um arquivo ou diretório existe
Descrição
$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.
Note:
Esta função retornará
FALSEpara links simbólicos apontando para arquivos inexistentes.
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.
Note:
A verificação é feita usando o real UID/GID ao invés do efetivo.
Exemplos
Example #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
Note: 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().
Veja Também
- is_readable() - Diz se o arquivo pode ser lido
- is_writable() - Diz se o arquivo pode ser modificado
- is_file() - Informa se o arquivo é um arquivo comum (não é diretório)
- file() - Lê todo o arquivo para um array