array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.file-exists.php', 1 => 'file_exists', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções do sistema de arquivos', ), 'prev' => array ( 0 => 'function.fgetss.php', 1 => 'fgetss', ), 'next' => array ( 0 => 'function.file-get-contents.php', 1 => 'file_get_contents', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/filesystem/functions/file-exists.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
file_exists — Verifica se um arquivo ou diretório existe
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.
Retorna true
se o arquivo ou diretório especificado por
filename
existe; false
caso contrário.
Nota:
Esta função retorna
false
para ligações simbólicas apontando para arquivos inexistentes.
Nota:
O teste é realizado utilizando o UID/GID real, em vez de outro valor efetivo.
Nota: Como o tipo inteiro do PHP possui sinal e muitas plataformas usam números inteiros de 32 bits, algumas funções do sistema de arquivos podem retornar resultados inesperados para arquivos maiores que 2GB.
Em caso de falha, um E_WARNING
será emitido.
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";
}
?>
Nota: Os resultados desta função são armazenados em cache. Consulte a função clearstatcache() para mais detalhes.
A partir do PHP 5.0.0, esta função também pode ser usada com alguns wrappers URL. Consulte os Protocolos e Wrappers suportados para determinar quais wrappers suportam a família de funções stat().