stat

(PHP 3, PHP 4 , PHP 5)

stat -- Obtem informações sobre um arquivo

Descrição

array stat ( string filename )

Coleta estatísticas do arquivo informado em filename. Se filename for um link simbólico, estatísticas serão do próprio arquivo, não do link. lstat() é idêntica a stat(), exceto que ela busca as estatísticas do symlink.

Em caso de erro, stat() retorna FALSE e também dispara um alerta.

Retorna um array com as estatísticas do arquivo com os seguintes elementos. Esse array é baseado no zero. Além de retornar esses elemtos de uma maneira numérica, eles podem ser acessados através de índices associativos, como informado ao lado de cada parâmetro. Isto foi acrescentado no PHP 4.0.6:

Tabela 1. Formato de retorno de stat() e fstat()

Índice NuméricoÍndice Associativo (desde o PHP 4.0.6)Descrição
0devdevice number / número do dispositivo
1inoinode number / número do inode
2modeinode protection mode / modo de proteção do inode
3nlinknumber of links / número de links
4uiduserid of owner / userid do proprietário
5gidgroupid of owner / groupid do proprietário
6rdevdevice type, if inode device * / tipo do dispositivo
7sizesize in bytes / tamanho em bytes
8atimetime of last access (unix timestamp) / horário último acesso
9mtimetime of last modification (unix timestamp) / horário última modificação
10ctimetime of last change (unix timestamp) / horário última alteração
11blksizeblocksize of filesystem IO * / tamanho do bloco no sistema de arquivos
12blocksnumber of blocks allocated / número de blocos alocados
* - somente disponível em sistemas que suportem st_blksize. Outros sistemas (como o Windows) retornam -1.

Nota: O resultado desta função é cacheada. Veja clearstatcache() para mais detalhes.

Nota: Esta função não trabalha com arquivos remotos, de forma que o arquivo a ser examinado precisa ser acessível pelo sistema de arquivos do servidor.

Veja também lstat(), fstat(), filemtime() e filegroup().