PHP 4, PHP 5, PHP 7, PHP 8
lstat - Gives information about a file or symbolic link
Code Examples

lstat( string$filename ): array|false

Gathers the statistics of the file or symbolic link named by filename.



Path to a file or a symbolic link.

Return Values

See the manual page for stat for information on the structure of the array that lstat returns. This function is identical to the stat function except that if the filename parameter is a symbolic link, the status of the symbolic link is returned, not the status of the file pointed to by the symbolic link.

On failure, false is returned.

Exceptions and Errors

Upon failure, an E_WARNING is emitted.



The results of this function are cached. See clearstatcache for more details.

As of PHP 5.0.0, this function can also be used with some URL wrappers. Refer to to determine which wrappers support stat family of functionality.

Related Functions

Example of lstat

Show all examples for lstat

PHP Version: