touch

(PHP 4, PHP 5, PHP 7)

touch Setzt die Zugriffs- und Modifikationszeit einer Datei

Beschreibung

touch ( string $filename [, int $time = time() [, int $atime ]] ) : bool

Versucht die Zugriffs- und Modifikationszeit der im filename-Parameter angegebenen Datei auf time zu setzen. Beachten Sie, 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.

time

Die Modifikationszeit. Wenn time nicht angegeben ist, wird die aktuelle Systemzeit verwendet.

atime

Falls angegeben, wird die Zugriffszeit der angegebenen Datei auf atime gesetzt. Andernfalls wird sie auf den angegebenen time-Parameter gesetzt. Falls beide nicht angegeben wurden, wird die aktuelle Systemzeit verwendet.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version Beschreibung
5.3.0 Es wurde ermöglicht, die Modifikationszeit eines Verzeichnisses unter Windows zu ändern.

Beispiele

Beispiel #1 touch()-Beispiel

if (touch($filename)) {
    echo $filename . '-Modifikationszeit 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 time-Parameter

<?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.

Warnung

Vor PHP 5.3.0 war es nicht möglich, die Modifikationszeit eines Verzeichnisses mit dieser Funktion unter Windows zu ändern.