Перейти к содержимому

filectime()

Что такое функция filectime()?

Функция filectime() — это встроенная функция PHP, которая возвращает время изменения inode файла. Эта функция возвращает Unix-метку времени, соответствующую моменту последнего изменения метаданных файла (например, прав доступа или владельца). Обратите внимание, что filectime() не отслеживает изменения содержимого; для получения времени последнего изменения содержимого используйте filemtime().

Ниже приведён базовый синтаксис функции filectime():

Синтаксис filectime() в PHP

php
filectime(filename);

Где filename — имя проверяемого файла.

Как использовать функцию filectime()?

Использование функции filectime() довольно просто. Следуйте приведённым ниже шагам:

  1. Вызовите функцию filectime(), передав в неё имя проверяемого файла.
  2. Функция вернёт Unix-метку времени, соответствующую времени изменения inode, или false в случае ошибки.
  3. Вы можете отформатировать полученную Unix-метку времени с помощью функции date(), чтобы вывести её в более удобном для чтения виде.

Ниже приведён пример кода, демонстрирующий использование функции filectime():

Как использовать функцию filectime()?

php
<?php

$filename = 'myfile.txt';
$last_change_time = filectime($filename);

if ($last_change_time !== false) {
    $change_time_string = date('F d Y H:i:s', $last_change_time);
    echo "The file $filename had its inode changed on $change_time_string";
} else {
    echo "Could not retrieve inode change time for $filename.";
}

Примечание: параметр filename принимает как относительные, так и абсолютные пути. Если используется относительный путь, он разрешается относительно текущей рабочей директории.

В этом примере мы проверяем время изменения inode для myfile.txt с помощью функции filectime(). Полученная Unix-метка времени сохраняется в переменной $last_change_time. Сначала код проверяет, что функция не вернула false, а затем форматирует метку времени с помощью date(). Обратите внимание, что date() использует часовой пояс по умолчанию на сервере; используйте date_default_timezone_set(), если требуется вывод в конкретном часовом поясе. Наконец, выводится сообщение, указывающее, когда метаданные файла были изменены в последний раз.

Заключение

Функция filectime() — полезный инструмент в PHP для проверки времени последнего изменения inode или метаданных файла. Следуя шагам, описанным в этом руководстве, вы сможете легко использовать filectime() в своих PHP-проектах. Не забудьте использовать filemtime(), если вам конкретно требуется время последнего изменения содержимого.

Практика

Что делает функция filectime() в PHP?

Считаете ли это полезным?

Предпросмотр dual-run — сравните с маршрутами Symfony на продакшене.