PHP 7.2.0 Beta 3 Released


(PHP 4, PHP 5, PHP 7)

lstatGives information about a file or symbolic link


array lstat ( string $filename )

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



Path to a file or a symbolic link.

Valorile întoarse

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.


Example #1 Comparison of stat() and lstat()


// Contrast information for uploads.php and uploads
array_diff(stat('uploads'), lstat('uploads'));

Exemplul de mai sus va afișa ceva similar cu:

Information that differs between the two files.

    [ino] => 97236376
    [mode] => 33188
    [size] => 34
    [atime] => 1223580003
    [mtime] => 1223581848
    [ctime] => 1223581848
    [blocks] => 8


În cazul eșecului este emis un E_WARNING.


Notă: Rezultatele acestei funcții sunt stocate în cache. Accesați clearstatcache() pentru mai multe detalii.


Începând cu PHP 5.0.0 această funcție poate fi utilizată de asemenea cu unele învelișuri URL. Referiți-vă la Supported Protocols and Wrappers pentru a determina care învelișuri susțin familia de funcționalitate stat().

A se vedea și

  • stat() - Gives information about a file

add a note add a note

User Contributed Notes 1 note

salsi at icosaedro dot it
1 year ago
This function fails and returns FALSE with files larger than 2 GB on Linux 32-bits (PHP 7.1.0-dev):

    $ dd if=/dev/zero of=/tmp/huge bs=1048576 count=2050
    $ php -r 'var_dump(lstat("/tmp/huge"));'
    --> Warning: lstat(): Lstat failed for /tmp/huge in Command line code on line 1

Window not tested. PHP 64-bits not tested.
To Top