lstat

FunctionParams and return types changed in PHP 8.0

Gives information about a file or symbolic link.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

lstat Function synopsis

lstat(string $filename): array|false

Parameters

$filename

Typestring

Path to a file or a symbolic link.

Return value

Typearray|false

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.

Changes to the lstat Function

PHP 8.0

  • Return type added: array|false
  • Parameter type added for parameter #1 ($filename): string
- lstat($filename)
+ lstat(string $filename): array|false

lstat Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes