stat
(PHP 4, PHP 5, PECL maxdb:7.5.00.24-7.6.00.38)
stat — Információkat ad egy fájlról
Leírás
Statisztikákat gyűjt össze a filename paraméterben megnevezett fájlról. Ha a filename paraméter egy jelképes link, a statisztikák magáról a fájlról szólnak, nem a linkről. A lstat() függvény ugyanaz, mint a stat() függvény, kivéve azt, hogy jelképes linkek esetén a link adatait adja vissza.
Hiba esetén a stat() függvény FALSE-szal tér vissza. Emellett még figyelmeztetést is ad.
Egy tömböt ad vissza, ami tartalmazza a statisztikákat a fájlról a következő elemekben. Ez a tömb nulla alapú. Ezek az attribútumok a a numerikus mód mellett elérhetőek asszociatív mutatók segítségével is, ezeket minden paraméter mellé odaírtuk; ez a lehetőség PHP 4.0.6 óta érhetó el:
| Numerikus | Asszociatív (PHP 4.0.6 óta) | Leírás |
|---|---|---|
| 0 | dev | eszköz (device) szám |
| 1 | ino | inode szám |
| 2 | mode | inode védelmi jogosultságok (mode) |
| 3 | nlink | linkek száma |
| 4 | uid | tulajdonos felhasználói azonosítója (userid) |
| 5 | gid | tuladjonos csoportjának azonosítója (groupid) |
| 6 | rdev | eszköz típusa, ha inode eszköz * |
| 7 | size | méret bájtokban |
| 8 | atime | utolsó hozzáférés időpontja (Unix időbélyeg) |
| 9 | mtime | utolsó módosítás időpontja (Unix időbélyeg) |
| 10 | ctime | utolsó inode-változás időpontja (Unix időbélyeg) |
| 11 | blksize | fájlrendszer IO blokkmérete * |
| 12 | blocks | kiosztott blokkok száma |
Note: Eme függvény eredményei elsőként csupán a gyorstárba kerülnek, nem lesznek azonnali hatással a fájlrendszerre. További információk a clearstatcache() oldalon olvashatók.
Az PHP 5.0.0> változattól kezdődően ez a függvény néhány URL burkolóval megadott erőforrással is együttműködik. A List of Supported Protocols/Wrappers oldalon olvasható azon burkolók listája, amelyek támogatják a stat() és hasonlatos függvényeket.
Lásd még: lstat(), fstat(), filemtime() és filegroup().