lstat

    (PHP 4, PHP 5, PHP 7, PHP 8)

    lstat — Obtém informações sobre um arquivo ou ligação simbólica

    Descrição

    lstat(string $filename): array|false

    Obtém estatísticas do arquivo ou ligação simbólica com o nome de filename.

    Parâmetros

    filename

    Caminho para um arquivo ou ligação simbólica.

    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 é idêntica a stat() exceto que se o parâmetro filename é uma ligação simbólica, e o status da ligação simbólica é retornado e não o status do arquivo apontado pela ligação simbólica.

    Em caso de falhas retorna false.

    Erros/Exceções

    Em caso de falha, um E_WARNING será emitido.

    Exemplos

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

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

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

    O exemplo acima produzirá algo semelhante a:

    Informação que difere entre os dois arquivos: 

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

    Notas

    Nota: Os resultados desta função são armazenados em cache. Consulte a função clearstatcache() para mais detalhes.

    Dica

    A partir do PHP 5.0.0, esta função também pode ser usada com alguns empacotadores de URL. Consulte os Protocolos e empacotadores suportados para determinar quais empacotadores suportam a família de funções stat().

    Veja Também

    • stat() - Obtém informações sobre um arquivo

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 2 notes

    up
    -1
    HP@SG
    4 years ago
    Just for information and in reply to a previous message left 4 years ago by "salsi at icosaedro dot it" :Files larger than 2 GiB can be handled on 64-bit Linux systems.My test in a terminal is as follow (using <?php ;?> tags to colour the results for ease of reading) :$ php -v<?php"PHP 7.2.24-0ubuntu0.18.04.7 (cli) (built: Oct  7 2020 15:24:25) ( NTS )Copyright (c) 1997-2018 The PHP GroupZend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies    with Zend OPcache v7.2.24-0ubuntu0.18.04.7, Copyright (c) 1999-2018, by Zend Technologies";?>$ date ; dd if=/dev/zero of=/tmp/php_test_huge bs=1024K count=2100 ; date ; ls -l /tmp/php_test_huge<?php"Wed Nov 11 15:35:46 +08 20202100+0 records in2100+0 records out2202009600 bytes (2.2 GB, 2.1 GiB) copied, 4.79192 s, 460 MB/sWed Nov 11 15:35:51 +08 2020-rw-r--r-- 1 harold harold 2202009600 Nov 11 15:35 /tmp/php_test_huge";?>$ php -r 'var_dump(lstat("/tmp/php_test_huge"));'<?php"array(26) {  [0]=>  int(2050)  [1]=>  int(19923027)  [2]=>  int(33188)  [3]=>  int(1)  [4]=>  int(1000)  [5]=>  int(1000)  [6]=>  int(0)  [7]=>  int(2202009600)  [8]=>  int(1605079647)  [9]=>  int(1605080149)  [10]=>  int(1605080149)  [11]=>  int(4096)  [12]=>  int(4300808)  ["dev"]=>  int(2050)  ["ino"]=>  int(19923027)  ["mode"]=>  int(33188)  ["nlink"]=>  int(1)  ["uid"]=>  int(1000)  ["gid"]=>  int(1000)  ["rdev"]=>  int(0)  ["size"]=>  int(2202009600)  ["atime"]=>  int(1605079647)  ["mtime"]=>  int(1605080149)  ["ctime"]=>  int(1605080149)  ["blksize"]=>  int(4096)  ["blocks"]=>  int(4300808)}";?>
    up
    -3
    salsi at icosaedro dot it
    9 years 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 1Window not tested. PHP 64-bits not tested.
    ＋adicione uma nota
    To Top