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

# touch

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

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

### Описание

function 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 'Изменение модификации файла прошло успешно';
    }
    ?>

### Примечания

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open