touch
(PHP 4, PHP 5, PHP 7, PHP 8)
touch — Setzt die Zugriffs- und Modifikationszeit einer Datei
Beschreibung
$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
mtimenullist, wird die aktuelle Systemzeit (time()) verwendet. -
atime -
Wenn nicht
null, wird die Zugriffszeit der angegebenen Datei aufatimegesetzt. Andernfalls wird sie auf den Wert des angegebenen Parametersmtimegesetzt. Wenn beidenullsind, 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.
