touch
Setzt die Zugriffs- und Modifikationszeit einer Datei
Beschreibung
bool touch
( string $filename
[, int $time = time()
[, int $atime
]] )
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.
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.