(PHP 4, PHP 5)
stat — Obtem informações sobre um arquivo
$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.
filename
Caminho para o arquivo.
| Í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 |
Em caso de erro, stat() retorna FALSE.
Em caso de falha, um E_WARNING é emitido.
| 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 |
Nota: Os resultados desta função são cacheados. Veja clearstatcache() para mais detalhes.
A partir do PHP 5.0.0, esta função também pode ser utilizada com alguns wrappers URL. Veja Supported Protocols and Wrappers para uma lista de quais wrappers são suportados pela família de funções stat().