filemtime

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

filemtimeGets file modification time

Опис

filemtime(string $filename): int|false

This function returns the time when the data blocks of a file were being written to, that is, the time when the content of the file was changed.

Параметри

filename

Path to the file.

Значення, що повертаються

Returns the time the file was last modified, або false в разі помилки. The time is returned as a Unix timestamp, which is suitable for the date() function.

Помилки/виключення

Під час збоїв буде видаватись E_WARNING.

Приклади

Приклад #1 filemtime() example

<?php
// outputs e.g. somefile.txt was last modified: December 29 2002 22:16:23.

$filename = 'somefile.txt';
if (
file_exists($filename)) {
echo
"$filename was last modified: " . date ("F d Y H:i:s.", filemtime($filename));
}
?>

Примітки

Зауваження:

Варто зауважити, що точність часових міток у різних файлових систем може бути різна.

Зауваження: Рузультати цієї функції кешуються. Докладніше: clearstatcache().

Підказка

Починаючи з PHP 5.0.0, ця функція також може бути використана з деякими URL-обгортками. На сторінці Підтримувані протоколи та обгортки вказано, які обгортки підтримують сімейство функцій stat().

Прогляньте також

  • filectime() - Gets inode change time of file
  • stat() - Gives information about a file
  • touch() - Sets access and modification time of file
  • getlastmod() - Gets time of last page modification