touch

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

touch — Устанавливает время доступа и модификации файла

Описание

touch(string $filename, ?int $mtime = null, ?int $atime = null): bool

Пытается установить время доступа и модификации файла с именем filename в значение mtime. Обратите внимание, что время доступа изменяется всегда, независимо от количества аргументов.

Если файл не существует, он будет создан.

Список параметров

filename: Имя изменяемого файла.
mtime: Время изменения. Если аргумент mtime равен null, используется текущее системное время (time()).
atime: Если значение параметра не null, время доступа указанного файла будет установлено в значение atime. В обратном случае оно будет установлено в значение параметра mtime. Если же оба этих параметра равны null, то будет использовано текущее системное время.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
8.0.0	Параметр `mtime` и `atime` теперь допускают значение `null`.

Примеры

Пример #1 Пример использования функции touch()

<?php
if (touch($filename)) {
    echo "Время модификации файла $filename было изменено на текущее";
} else {
    echo "Простите, не удалось изменить время модификации файла ' . $filename;
}
?>

Пример #2 Использование touch() с параметром mtime

<?php
// Это время касания, установим его на час назад.
$time = time() - 3600;

// Изменяем файл
if (!touch('some_file.txt', $time)) {
    echo 'Упс, что-то пошло не так...';
} else {
    echo 'Изменение модификации файла прошло успешно';
}
?>

Примечания

Замечание:
Обратите внимание, файловые системы обрабатывают время по-разному.