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

filectime

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

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

Descrição

filectime(string $filename): int|false

Obtém o horário de modificação do inode de um arquivo.

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.

Erros/Exceções

Em caso de falha, um E_WARNING será emitido.

Exemplos

Exemplo #1 Exemplo de filectime()

<?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.", filectime($filename));
}

?>

Notas

Nota:

Nota: Na maioria dos sistemas de arquivos Unix, um arquivo é considerado modificado quando seus dados de inode são modificados; isto é, quando as permissões, proprietário, grupo ou outros metadados do inode são atualizados. Consulte também filemtime() (que é usado quando se deseja criar rodapés de páginas web do tipo "Última Modificação") e fileatime().

Nota:

Note também que em alguns textos sobre Unix o horário de modificação de um arquivo é definido como sendo o horário de criação do arquivo. Isto está errado. Não existe horário de criação para arquivos na maioria dos sistemas de arquivos Unix.

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