PHP 7.1.0 Alpha 2 Released

lstat

(PHP 4, PHP 5, PHP 7)

lstatObtém informações sobre um arquivo ou link simbólico

Descrição

array lstat ( string $filename )

Obtém estatísticas do arquivo ou link simbólico com o nome de filename.

Parâmetros

filename

Path to a file or a symbolic link.

Valor Retornado

Veja a página do manual para stat() para informações sobre a estrutura do array retornado que lstat() retorna. Esta função é identica a stat() exceto que se o parâmetro filename é um link simbólico, e o status do link simbólico é retornado e não o status do arquivo apontando pelo link simbólico.

Exemplos

Exemplo #1 Comparação de stat() e lstat()

<?php
symlink
('uploads.php''uploads');

// Contraste a informação de uploads.php e uploads
array_diff(stat('uploads'), lstat('uploads'));
?>

O exemplo acima irá imprimir algo similar à:

Informação que diferece entre os dois arquivos:

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

Erros

Em caso de falha um E_WARNING será emitido.

Notas

Nota: Os resultados desta função são cacheados. Veja clearstatcache() para mais detalhes.

Dica

A partir do PHP 5.0.0, esta função também pode ser utilizada com alguns wrappers URL. Veja Protocolos e Wrappers suportados para uma lista de quais wrappers são suportados pela família de funções stat().

Veja Também

  • stat() - Obtem informações sobre um arquivo

add a note add a note

User Contributed Notes 1 note

up
0
salsi at icosaedro dot it
5 months 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