touch

(PHP 4, PHP 5, PHP 7)

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