função stat() do PHP

Funções do Sistema de Arquivos PHP

definição e uso

a função stat() retorna informações sobre o arquivo.

sintaxe

fstat(file)
parâmetro descrição
file obrigatório. Especifica o arquivo a ser verificado.

descrição

obter por file informações estatísticas do arquivo especificado. Se file se for um link simbólico, as informações estatísticas são sobre o arquivo conectado, não sobre o link simbólico.

se houver erro, stat() retorna false e dispara um aviso.

o array retornado contém informações estatísticas do arquivo, o array possui as seguintes unidades listadas, os índices do array começam do zero. A partir do PHP 4.0.6, também pode ser acessado através de índices associativos além dos índices numéricos.

formato de retorno de stat()

índice numérico nome da chave associativa (desde PHP 4.0.6) descrição
0 dev nome do dispositivo
1 ino número
2 mode modo de proteção do inode
3 nlink número de conexões
4 uid ID do usuário do proprietário
5 gid ID do grupo do proprietário
6 rdev tipo de dispositivo, se for um dispositivo inode
7 size número de bytes do tamanho do arquivo
8 atime último acesso (timestamp Unix)
9 mtime última modificação (timestamp Unix)
10 ctime última alteração (timestamp Unix)
11 blksize Tamanho do bloco de E/S do sistema de arquivos
12 blocks Número de blocos ocupados

Dicas e comentários

Dica:lstat() Semelhante à stat(), a diferença é que ela retorna o estado do link simbólico.

Comentário:O resultado desta função será armazenado em cache. Use clearstatcache() para limpar o cache.

Exemplo

<?php
$file = fopen("test.txt","r");
print_r(stat($file));
fclose($file);
?>

Saída semelhante a:

Array
(
[0] => 0
[1] => 0
[2] => 33206
[3] => 1
[4] => 0
[5] => 0
[6] => 0
[7] => 92
[8] => 1141633430
[9] => 1141298003
[10] => 1138609592
[11] => -1
[12] => -1
[dev] => 0
[ino] => 0
[mode] => 33206
[nlink] => 1
[uid] => 0
[gid] => 0
[rdev] => 0
[size] => 92
[atime] => 1141633430
[mtime] => 1141298003
[ctime] => 1138609592
[blksize] => -1
[blocks] => -1
)

Funções do Sistema de Arquivos PHP