PHP stat() Function

PHP Filesystem Reference Complete PHP Filesystem Reference

Definition and Usage

The stat() function returns information about a file.

This function returns an array with the following elements:

  • [0] or [dev] - Device number
  • [1] or [ino] - Inode number
  • [2] or [mode] - Inode protection mode
  • [3] or [nlink] - Number of links
  • [4] or [uid] - User ID of owner
  • [5] or [gid] - Group ID of owner
  • [6] or [rdev] - Inode device type
  • [7] or [size] - Size in bytes
  • [8] or [atime] - Last access (as Unix timestamp)
  • [9] or [mtime] - Last modified (as Unix timestamp)
  • [10] or [ctime] - Last inode change (as Unix timestamp)
  • [11] or [blksize] - Blocksize of filesystem IO (if supported)
  • [12] or [blocks] - Number of blocks allocated



Parameter Description
filename Required. Specifies the path to the file

Tips and Notes

Note: The results from this function will differ from server to server. The array may contain the number index, the name index, or both.

Note: The result of this function are cached. Use clearstatcache() to clear the cache.


$stat = stat('test.txt');
echo 'Acces time: ' .$stat['atime'];
echo '<br />Modification time: ' .$stat['mtime'];
echo '<br />Device number: ' .$stat['dev'];

The output of the code above could be:

Access time: 1141633430
Modification time: 1141298003
Device number: 0

PHP Filesystem Reference Complete PHP Filesystem Reference