touch

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

    touch — Setzt die Zugriffs- und Modifikationszeit einer Datei

    Beschreibung

    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 mtimenull 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

    VersionBeschreibung
    8.0.0mtime 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.

    To Top