stat

(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 foi baseada no status de links simbólicos.

Parâmetros

filename

Caminho para o arquivo.

Valor Retornado

Formato de retorno de stat() e fstat()
Índice Numérico Índice Associativo (desde o PHP 4.0.6) Descrição
0 dev número do dispositivo
1 ino número do inode
2 mode modo de proteção do inode
3 nlink número de links
4 uid userid do proprietário
5 gid groupid do proprietário
6 rdev tipo de dispositivo
7 size tamanho em bytes
8 atime hora do último acesso (Unix timestamp)
9 mtime hora da última modificação (Unix timestamp)
10 ctime hora da última modificação do inode (Unix timestamp)
11 blksize tamanho do bloco no sistema de arquivos
12 blocks número de blocos alocados
* Somente válido em sistemas suportando o tipo st_blksize - outros sistemas (e.g. Windows) retorna -1.

Em caso de erro, stat() retorna FALSE.

Erros

Em caso de falha, um E_WARNING é emitido.

Changelog

Versão Descrição
4.0.6 Além de retornar estes atributos em um array numérico, eles podem ser acessados com índices associativos, como notado para cada parâmetro

Notas

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

Tip

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

  • lstat() - Obtém informações sobre um arquivo ou link simbólico
  • fstat() - Lê informações sobre um arquivo usando um ponteiro de arquivo aberto
  • filemtime() - Obtém o tempo de modificação do arquivo
  • filegroup() - Lê o grupo do arquivo