Latest web development tutorials
 

PHP lstat() Function


< Complete PHP Filesystem Reference

Definition and Usage

The lstat() function returns information about a file or symbolic link.

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

lstat(file)

Parameter Description
file Required. Specifies the file to check

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 stat() , except that if the file parameter is a symbolic link, the status of the symlink is returned (not the status of the file pointed to by the symlink).


Example

<?php
print_r(lstat("test.txt"));
?>

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