array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.fileatime.php', 1 => 'fileatime', 2 => 'Obtém o último horário de acesso do arquivo', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções de Filesystem', ), 'prev' => array ( 0 => 'function.file-put-contents.php', 1 => 'file_put_contents', ), 'next' => array ( 0 => 'function.filectime.php', 1 => 'filectime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/filesystem/functions/fileatime.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

fileatime

(PHP 4, PHP 5, PHP 7, PHP 8)

fileatime — Obtém o último horário de acesso do arquivo

Descrição

fileatime(string $filename): int|false

Obtém o último horário de acesso do arquivo.

Parâmetros

filename

Caminho para o arquivo.

Valor Retornado

Retorna o horário em que um arquivo foi acessado pela última vez, ou false em caso de falha. O horário é retornado como um timestamp Unix.

Erros/Exceções

Em caso de falha, um E_WARNING será emitido.

Exemplos

Exemplo #1 Exemplo de fileatime()

<?php

// Exibe algo como: arquivo.txt teve o último acesso em: December 29 2002 22:16:23.

$filename = 'arquivo.txt';
if (file_exists($filename)) {
echo "$filename teve o último acesso em: " . date ("F d Y H:i:s.", fileatime($filename));
}

?>

Notas

Nota:

O horário de acesso de um arquivo deve mudar sempre os blocos de dados de um arquivo estão sendo lidos. Isto pode ser custoso do ponto de vista de desempenho quando uma aplicação acessa regularmente um grande número de arquivos ou diretórios.

Alguns sistemas de arquivos Unix podem ser montados com atualizações de horário de acesso desabilitadas para aumentar o desempenho de tais aplicações; os spools de notícias da USENET são um exemplo comum. Nestes sistemas de arquivos esta função não terá utilidade.

Nota:

Note que a resolução de tempo pode variar de um sistema de arquivos para outro.

Nota: Os resultados desta função são armazenados em cache. Consulte a função clearstatcache() para mais detalhes.

Dica

A partir do PHP 5.0.0, esta função também pode ser usada com alguns empacotadores de URL. Consulte os Protocolos e empacotadores suportados para determinar quais empacotadores suportam a família de funções stat().

Veja Também