PHP stat() Function

The stat() function returns information about a file.

array stat ( string $filename )

Gathers the statistics of the file named by filename. If filename is a symbolic link, statistics are from the file itself, not the symlink.

lstat() is identical to stat() except it would instead be based off the symlinks status.

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

Example -

<?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']; ?>

Example -

<?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...'; } } ?>

Parameter	Description
filename	Specifies the path to the file