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

Описание

touch ( string $filename [, int $time = time() [, int $atime ]] ) : bool

Пытается установить время доступа и модификации файла с именем 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 с помощью этой функции.