PHP Tutorial - PHP lstat() Function






Definition

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

Syntax

lstat(file)

Parameter

ParameterIs RequiredDescription
fileRequired.File to check

Return

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




Note

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

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 code above generates the following result.