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(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.

Tip: This function is similar to fstat(), except that with this function the file does not have to be open.

Example

<?php
$file = fopen("test.txt","r");
print_r(stat($file));
fclose($file);
?> 

The output of the code above could be:

Array
(
[0] => 0
[1] => 0
[2] => 33206
[3] => 1
[4] => 0
[5] => 0
[6] => 0
[7] => 92
[8] => 1141633430
[9] => 1141298003
[10] => 1138609592
[11] => -1
[12] => -1
[dev] => 0
[ino] => 0
[mode] => 33206
[nlink] => 1
[uid] => 0
[gid] => 0
[rdev] => 0
[size] => 92
[atime] => 1141633430
[mtime] => 1141298003
[ctime] => 1138609592
[blksize] => -1
[blocks] => -1
)

Complete PHP Filesystem Reference

Learn XML with <oXygen/> XML Editor - Free Trial!

oXygen helps you learn to define, edit, validate and transform XML documents. Supported technologies include XML Schema, DTD, Relax NG, XSLT, XPath, XQuery, CSS. Understand in no time how XSLT and XQuery work by using the intuitive oXygen debugger! Do you have any XML related questions? Get free answers from the oXygen XML forum and from the video demonstrations. Download a FREE 30-day trial today!