(PHP 4, PHP 5)
touch — Setzt die Zugriffs- und Modifikationszeit einer Datei
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.
Der Name der zu ändernden Datei.
Die Modifikationszeit. Wenn time nicht angegeben ist, wird die aktuelle Systemzeit verwendet.
Falls angegeben, wird die Zugriffszeit der angegebenen Datei auf atime gesetzt. Andernfalls wird sie auf time gesetzt.
Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.
Version | Beschreibung |
---|---|
5.3.0 | Es wurde ermöglicht, die Modifikationszeit eines Verzeichnisses unter Windows zu ändern. |
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';
}
?>
Hinweis: Beachten Sie, dass die zeitliche Auflösung bei verschiedenen Dateisystemen unterschiedlich sein kann.
Vor PHP 5.3.0 war es nicht möglich, die Modifikationszeit eines Verzeichnisses mit dieser Funktion unter Windows zu ändern.