touch - Устанавливает время доступа и модификации файла
Вернуться к: Файловая система
touch
(PHP 4, PHP 5, PHP 7)
touch — Устанавливает время доступа и модификации файла
Описание
$filename
[, int $time = time()
[, int $atime
]] )
Пытается установить время доступа и модификации файла с именем
filename в значение time.
Обратите внимание, что время доступа изменяется всегда, независимо от
количества аргументов.
Если файл не существует, он будет создан.
Список параметров
-
filename -
Имя касаемого файла.
-
time -
Время касания. Если аргумент
timeне указан, используется текущее время. -
atime -
Если передан, время доступа указанного файла будет установлено в значение
atime. В обратном случае оно будет установлено в значение параметраtime. Если же ни один из этих параметров не был указан, то будет использовано текущее системное время.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 5.3.0 | Стало возможным изменять время модификации директории в Windows. |
Примеры
Пример #1 Пример использования функции touch()
<?php
if (touch($filename)) {
echo "Время модификации файла $filename было изменено на текущее";
} else {
echo "Простите, не удалось изменить время модификации файла ' . $filename;
}
?>
Пример #2 Использование touch() с параметром time
<?php
// Это время касания, установим его на час назад.
$time = time() - 3600;
// Трогаем файл
if (!touch('some_file.txt', $time)) {
echo 'Упс, что-то пошло не так...';
} else {
echo 'Касание файла прошло успешно';
}
?>
Примечания
Замечание:
Учтите, что обработка времени может отличаться в различных файловых системах.
До версии PHP 5.3.0 было невозможно менять время модификации директории под Windows с помощью этой функции.
Вернуться к: Файловая система