Setzt die Zugriffs- und Modifikationszeit einer Datei

# touch

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

touch — Setzt die Zugriffs- und Modifikationszeit einer Datei

### Beschreibung

function 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