array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.fileatime.php', 1 => 'fileatime', 2 => 'Liefert die Zeit des letzten Zugriffs auf eine Datei', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Dateisystem', ), 'prev' => array ( 0 => 'function.file-put-contents.php', 1 => 'file_put_contents', ), 'next' => array ( 0 => 'function.filectime.php', 1 => 'filectime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/filesystem/functions/fileatime.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

fileatime

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

fileatime — Liefert die Zeit des letzten Zugriffs auf eine Datei

Beschreibung

fileatime(string $filename): int|false

Gibt Zeit des letzten Zugriffs auf die übergebene Datei zurück.

Parameter-Liste

filename

Pfad zu der Datei.

Rückgabewerte

Gibt die Zeit des letzten Zugriffs auf eine Datei zurück. Bei einem Fehler wird false zurückgegeben. Die Zeit wird als UNIX-Zeitstempel zurückgegeben.

Fehler/Exceptions

Im Fehlerfall wird eine E_WARNING ausgegeben.

Beispiele

Beispiel #1 fileatime()-Beispiel

<?php

// Ausgabe z. B.: Letzer Zugriff auf somefile.txt: December 29 2002 22:16:23.

$filename = 'somefile.txt';
if (file_exists($filename)) {
echo "Letzer Zugriff auf $filename: " . date("F d Y H:i:s.", fileatime($filename));
}

?>

Anmerkungen

Hinweis:

Der atime-Wert einer Datei soll sich immer dann ändern, wenn die Dateiblöcke einer Datei gelesen werden. Dies kann in Bezug auf die Performance teuer sein, falls eine Anwendung regelmäßig auf eine sehr große Anzahl an Dateien oder Verzeichnissen zugreift.

Einige Unix-Dateisysteme können so eingebunden werden, dass die Aktualisierung von atime ausgeschaltet ist, um die Performace solcher Anwendungen zu steigern. USENET-News-Spools sind ein bekanntes Beispiel. Auf solchen Dateisystemen ist diese Funktion nutzlos.

Hinweis:

Beachten Sie, dass die zeitliche Auflösung bei verschiedenen Dateisystemen unterschiedlich sein kann.

Hinweis: Die Ergebnisse dieser Funktion werden zwischengespeichert. Weitere Details sind bei clearstatcache() zu finden.

Tipp

Seit PHP 5.0.0 kann diese Funktion mit einigen URL-Wrappern benutzt werden. Schauen Sie in der Liste unter Unterstützte Protokolle und Wrapper nach, welcher Wrapper die Funktionalität von stat() unterstützt.

Siehe auch