array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.touch.php', 1 => 'touch', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.tmpfile.php', 1 => 'tmpfile', ), 'next' => array ( 0 => 'function.umask.php', 1 => 'umask', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/touch.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
touch — Устанавливает время доступа и модификации файла
Пытается установить время доступа и модификации файла с именем
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 'Изменение модификации файла прошло успешно';
}
?>
Замечание:
Учтите, что обработка времени может отличаться в различных файловых системах.