Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

stat

Dateisystem-Funktionen

    Befehl:
array stat ( string $filename )


    Parameter-Liste:
NameBeschreibung
filenamePfad zu der Datei.

    Rückgabewerte:
stat() und fstat() Resultat format
NumericAssoziative (seit PHP 4.0.6)Beschreibung
0devGerätenummer
1inoInode-Nummer *
2modeInode-Schutzmodus
3nlinkAnzahl Links
4uidUser-Id des Besitzers *
5gidGruppen-Id Besitzers *
6rdevGerätetyp, falls Inode-Gerät.
7sizeGrösse in Bytes
8atimeZeit des letzten Zugriffs (Unix timestamp)
9mtimeZeit der letzten Modifikation (Unix timestamp)
10ctimeZeit der letzten Änderung (Unix timestamp)
11blksizeBlockgrösse für Dateisystem I/O **
12blocksAnzahl von 512-Byte-Blöcken zugewiesen **
* Unter Windows wird es immer 0 sein.

** Nur gültig für Systeme, die die st_blksize - anderen Systemen (zB Windows) -1 zurück.

    Beschreibung:
Mit stat() kann man sich verschiedene Informationen über eine Datei (filename) zurückgeben lassen.

Im Erfolgsfall gibt diese Funktion die Informationen über eine Datei in Form eines Arrays zurück, sonst wird false zurückgegeben.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Hinweis:
Hinweis:


Da PHP-Integer-Typ ist signiert und viele Plattformen 32bit, können einige Dateisystem-Funktionen zu unerwarteten Ergebnissen für Dateien, die grösser als 2 GB sind zurück.
Die Ergebnisse dieser Funktion werden gecached. Weitere Details erhalten Sie bei clearstatcache().


    Tips:
Tips:

Ab PHP 5.0.0 kann diese Funktion mit einigen URL-Wrapper verwendet werden. Siehe Unterstützte Protokolle and Wrappers, um festzustellen, welche Unterstützung stat()-Familie von Wrapper-Funktionalität.


    Fehler:
Im Fehlerfall wird eine E_WARNING geworfen.

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

stat() - Beispiel:


Eingabe:
<?PHP
$fp = 'members.txt';
$statistik = stat ( $fp );
while ( list ( $key, $val ) = each ( $statistik ) )
{
  echo $key . ': ' . $val . '<br>';
}
?>


Ausgabe:
0: 771          // Ger�t
1: 491065       // Inode
2: 33279        // Mode
3: 3            // Anzahl Links
4: 0            // User-Id des Besitzers
5: 100          // Gruppen-Id Besitzers
6: 0            // Ger�tetyp, falls Inode-Ger�t.*
7: 28           // Gr�sse in Bytes
8: 997556079    // Zeit des letzten Zugriffs
9: 997546715    // Zeit der letzten Modifikation
10: 997550109   // Zeit der letzten �nderung
11: 4096        // Blockgr�sse f�r Dateisystem I/O *
12: 8           // Anzahl der Bl�cke

Beschreibung:
Beachten Sie, dass die zeitliche Aufl�sung bei verschiedenen Dateisystemen unterschiedlich sein kann.

Beschreibung:
Version Beschreibung
4.0.6 Zusätzlich zum Zurück diese Attribute in einem numerischen Array, können sie mit assoziativen Indizes zugegriffen werden kann, wie erwähnt neben jedem Parameter.
stat() - Beispiel 2:


Eingabe:
<?PHP
/* Get file stat */
$stat = stat('C:\php\php.exe');

/*
 * Print file access time, this is the same
 * as calling fileatime()
 */
echo 'Access time: ' . $stat['atime'];

/*
 * Print file modification time, this is the
 * same as calling filemtime()
 */
echo 'Modification time: ' . $stat['mtime'];

/* Print the device number */
echo 'Device number: ' . $stat['dev'];
?>


Beschreibung:
Version Beschreibung
4.0.6 Zusätzlich zum Zurück diese Attribute in einem numerischen Array, können sie mit assoziativen Indizes zugegriffen werden kann, wie erwähnt neben jedem Parameter.
stat() - Beispiel 3: Mit stat()-Informationen zusammen mit touch()


Eingabe:
<?PHP
/* Get file stat */
$stat = stat('C:\php\php.exe');

/* Did we failed to get stat information? */
if (!$stat) {
    echo 'stat() call failed...';
} else {
    /*
     * We want the access time to be 1 week
     * after the current access time.
     */
    $atime = $stat['atime'] + 604800;

    /* Touch the file */
    if (!touch('some_file.txt', time(), $atime)) {
        echo 'Failed to touch file...';
    } else {
        echo 'touch() returned success...';
    }
}
?>


Beschreibung:
Version Beschreibung
4.0.6 Zusätzlich zum Zurück diese Attribute in einem numerischen Array, können sie mit assoziativen Indizes zugegriffen werden kann, wie erwähnt neben jedem Parameter.
Dateisystem-Funktionen