filemtime

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

filemtime — Obtém o horário de modificação do arquivo

Descrição

filemtime(string $filename): int|false

Esta função retorna o horário em que os blocos de dados de um arquivo estavam sendo escritos, isto é, o horário em que o conteúdo do arquivo foi modificado.

Parâmetros

filename

Caminho para o arquivo.

Valor Retornado

Retorna o horário em que o arquivo foi modificado pela última vez, ou false em caso de falha. O horário é retornado como um timestamp Unix, que é adequado para a função date().

Erros/Exceções

Em caso de falha, um E_WARNING será emitido.

Exemplos

Example #1 Exemplo de filemtime()

<?php
// exibe algo como: arquivo.txt foi modificado em December 29 2002 22:16:23.

$filename = 'arquivo.txt';
if (file_exists($filename)) {
    echo "$filename foi modificado em " . date ("F d Y H:i:s.", filemtime($filename));
}
?>

Notas

Note:

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

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

Tip

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

Veja Também

  • filectime() - Obtém o horário de modificação de inode do arquivo
  • stat() - Obtém informações sobre um arquivo
  • touch() - Define horário de acesso e de modificação de arquivo
  • getlastmod() - Obtém o horário da última modificação na página