stat

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

statSammelt Informationen über eine Datei

Beschreibung

stat(string $filename): array|false

Sammelt Statistiken über die per filename angegebene Datei. Falls filename ein symbolischer Link ist, beziehen sich die Statistiken auf die Datei selbst, nicht auf den symbolischen Link. Unter Windows NTS-Builds vor PHP 7.4.0 bezogen sich in diesem Fall die size, atime, mtime und ctime Statistiken auf den symbolischen Link.

lstat() ist identisch zu stat(), mit dem Unterschied, dass es sich auf den Status des symbolischen Links bezieht.

Parameter-Liste

filename

Pfad zur Datei.

Rückgabewerte

stat()- und fstat()-Ergebnisformat
Numerisch Assoziativ Beschreibung
0 dev Gerätenummer ***
1 ino Inode-Nummer ****
2 mode Inode-Schutzmodus *****
3 nlink Anzahl der Links
4 uid userid des Besitzers *
5 gid groupid des Besitzers *
6 rdev Gerätetyp, falls Inode-Gerät
7 size Größe in Bytes
8 atime Zeitpunkt des letzten Zugriffs (Unix-Timestamp)
9 mtime Zeitpunkt der letzten Änderung (Unix-Timestamp)
10 ctime Zeitpunkt der letzten Inode-Änderung (Unix-Timestamp)
11 blksize Blockgröße des Dateisystem-I/O **
12 blocks Anzahl der zugewiesenen 512-Byte-Blöcke **

* Unter Windows wird dies immer 0 sein.

** Nur gültig unter Systemen, die den st_blksize-Typ unterstützen - andere Systeme (z.B. Windows) geben -1 zurück.

*** Unter Windows, von PHP 7.4.0 an, ist dies die Seriennummer des Laufwerks, das die Datei enhält, welches eine 64-bit Ganzzahl ohne Vorzeichen ist, so dass auf 32-bit-Systemen ein Überlauf erfolgen kann. Zuvor war es die numerische Darstellung des Laufwerksbuchstabens (z.B. 2 für C:) für stat(), und 0 für lstat().

**** Unter Windows, von PHP 7.4.0 an, ist dies die mit der Datei assozierte Kennung, welche eine 64-bit Ganzzahl ohne Vorzeichen ist, so dass ein Überlauf erfolgen kann. Zuvor war es immer 0.

***** Unter Windows wird das Schreibberechtigungsbit entsprechend dem schreibgeschützten Dateiattribut gesetzt, und derselbe Wert wird für alle Benutzer, Gruppen und Besitzer gemeldet. Die ACL wird im Gegensatz zu is_writable() nicht berücksichtigt.

Der Wert von mode enthält Informationen, die von mehreren Funktionen gelesen werden. Wenn als Oktalzahl dargestellt und von rechts betrachtet, werden die ersten drei Ziffern von chmod() zurückgegeben. Die nächste Ziffer wird von PHP ignoriert. Die nächsten beiden Ziffern geben den Dateityp an:

mode Dateitypen
mode als Oktalzahl Bedeutung
0140000 socket
0120000 Verknüpfung
0100000 reguläre Datei
0060000 Block-Gerät
0040000 Verzeichnis
0020000 zeichenorientiertes Gerät
0010000 FIFO
So könnte beispielsweise eine reguläre Datei 0100644, und ein Verzeichnis 0040755 sein.

Im Fehlerfall gibt stat() false zurück.

Hinweis: Weil PHPs Integer Typ vorzeichenbehaftet ist und viele Platformen 32bit Integer verwenden, können einige Dateisystem-Funktionen für Dateien größer als 2GB unerwartete Ergebnisse liefern.

Fehler/Exceptions

Im Fehlerfall wird eine E_WARNING geworfen.

Changelog

Version Beschreibung
7.4.0 Unter Windows ist die Gerätenummer nun die Seriennummer des Laufwerks, das die Datei enthält, und die Inode-Nummer ist die mit der Datei assozierte Kennung.
7.4.0 Die size, atime, mtime and ctime Statistiken symbolischer Links sind nun immer die des Ziels. Dies war zuvor nicht der Fall für NTS-Builds unter Windows.

Beispiele

Beispiel #1 stat()-Beispiel

<?php
/* Hole Datei-Statistik */
$stat stat('C:\php\php.exe');

/*
 * Gebe den Zugriffszeitpunkt der Datei aus; dies entspricht dem
 * Aufruf von fileatime()
 */
echo 'Zugriffszeitpunkt: ' $stat['atime'];

/*
 * Gebe den Änderungszeitpunkt der Datei aus; dies entspricht dem
 * Aufruf von filemtime()
 */
echo 'Änderungszeitpunkt: ' $stat['mtime'];

/* Gebe die Gerätenummer aus */
echo 'Gerätenummer: ' $stat['dev'];
?>

Beispiel #2 Nutzung von stat()-Informationen zusammen mit touch()

<?php
/* Hole Datei-Statistik */
$stat stat('C:\php\php.exe');

/* Hat das Holen der Statistik-Informationen geklappt? */
if (!$stat) {
    echo 
'stat()-Aufruf schlug fehl ...';
} else {
    
/*
     * Wir wollen den Zugriffszeitpunkt auf eine Woche nach dem aktuellen
     * Zugriffszeitpunkt setzen.
     */
    
$atime $stat['atime'] + 604800;

    
/* Ändere die Datei */
    
if (!touch('eine_datei.txt'time(), $atime)) {
        echo 
'Ändern der Datei schlug fehl ...';
    } else {
        echo 
'touch()-Befehl war erfolgreich ...';
    }
}
?>

Anmerkungen

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

  • lstat() - Sammelt Informationen über eine Datei oder einen symbolischen Link
  • fstat() - Sammelt Informationen über eine Datei mittels eines offenen Dateizeigers
  • filemtime() - Liefert Datum und Uhrzeit der letzten Dateiänderung
  • filegroup() - Liefert die Gruppenzugehörigkeit einer Datei
  • SplFileInfo

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Total Commander 11.00 (final) ist verfügbar!

Total Commander, ein beliebter Datei-Manager, hat kürzlich seine neueste Version, 11.00, veröffentlicht. Mit einer Vielzahl von neuen Funktionen und Korrekturen bietet diese Version den Benutzern ein verbessertes und optimiertes Erlebnis. ...

admin

Autor : admin
Kategorie: Software-Updates

Welche Technologien sollte ein PHP Programmierer beherrschen?

In der heutigen digitalen Welt ist die Rolle eines PHP Programmierers von großer Bedeutung. ...

admin

Autor : admin
Kategorie: Dies und Das

PHPUnit in der Version 10 erschienen

PHPUnit in der Version 10 erschienen

Das beliebte Testframeworks PHPUnit ist in der Version 10 erschienen und steht zum Download bereit ...

TheMax

Autor : TheMax
Kategorie: Software & Web-Development

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

MySQL Autocomplete

Sie können zuerst Ihre Daten aus der Datenbank abrufen und in einem geeigneten Format speichern, z.B. als Array von Objekten. Jedes Objekt im Arr ...

Geschrieben von johnda am 03.10.2023 11:10:10
Forum: PHP Developer Forum
Bild drehen

Danke. In der PHP-Doku habe ich stundenlang gelesen. Das glaub ich nicht Aber die nützt leider nur etwas, wenn man die Lösung schon kennt. Man ...

Geschrieben von scatello am 02.10.2023 20:26:04
Forum: PHP Developer Forum
Bild drehen

Danke. In der PHP-Doku habe ich stundenlang gelesen. Aber die nützt leider nur etwas, wenn man die Lösung schon kennt. Man muss erst wissen, das ...

Geschrieben von Friedel am 02.10.2023 18:43:14
Forum: PHP Developer Forum
Bild drehen

Einfach mal in der PHP-Doku (ja, die gibt es tatsächlich) nachsehen, da findet man auch ganz viele Beispiele https://www.php.net/manual/de/funct ...

Geschrieben von scatello am 02.10.2023 17:59:00
Forum: PHP Developer Forum