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


(PHP 4, PHP 5)

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

Описание

bool touch ( string $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 с помощью этой функции.