# touch

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

touch — Setzt die Zugriffs- und Modifikationszeit einer Datei

### Beschreibung

touch(string `$filename`, ?int `$mtime` = `null`, ?int `$atime` = `null`): bool

Versucht, die Zugriffs- und Modifikationszeit der im Parameter `filename` angegebenen Datei auf `mtime` zu setzen. Zu beachten ist, dass die Zugriffszeit unabhängig von der Anzahl der Parameter immer geändert wird.

Wenn die Datei nicht existiert, wird sie erzeugt.

### Parameter-Liste

`filename`

  Der Name der zu ändernden Datei.

`mtime`

  Die Modifikationszeit. Wenn `mtime` `null` ist, wird die aktuelle Systemzeit (time()) verwendet.

`atime`

  Wenn nicht `null`, wird die Zugriffszeit der angegebenen Datei auf `atime` gesetzt. Andernfalls wird sie auf den Wert des angegebenen Parameters `mtime` gesetzt. Wenn beide `null` sind, wird die aktuelle Systemzeit verwendet.

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

### Changelog

Version | Beschreibung
--- | ---
8.0.0 | `mtime` und `atime` sind jetzt nullbar.

### Beispiele

Beispiel #1 touch()-Beispiel

`<?php
if (touch($filename)) {
echo 'Die Modifikationszeit von ' . $filename
. ' wurde auf die aktuelle Zeit gesetzt.';
} else {
echo 'Entschuldigung, die Änderung der Modifikationszeit von ' . $filename
. ' war nicht möglich.';
}
?>`

Beispiel #2 Nutzung von touch() mit dem Parameter `mtime`

`<?php
// Modifikationszeit (eine Stunde in der Vergangenheit)
$time = time() - 3600;
// Ändern der Datei
if (!touch('eine_datei.txt', $time)) {
echo 'Ein Fehler ist aufgetreten ...';
} else {
echo 'Änderung der Modifikationszeit war erfolgreich';
}
?>`

### Anmerkungen

> Hinweis:

> Beachten Sie, dass die zeitliche Auflösung bei verschiedenen Dateisystemen unterschiedlich sein kann.

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