PHP stat() Function
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
Syntax
stat(filename)
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.
Example
<?php
$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
Complete PHP Filesystem Reference