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"));
?>
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
)
(
[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
