Lê informações sobre um arquivo usando um ponteiro de arquivo aberto

# fstat

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

fstat — Lê informações sobre um arquivo usando um ponteiro de arquivo aberto

### Descrição

function fstat(resource `$stream`): array|false

Obtêm estatísticas do arquivo aberto pelo ponteiro de arquivos `stream`. Esta função é similar à função stat() exceto que ela opera em um ponteiro de arquivo aberto ao invés de um nome de arquivo.

### Parâmetros

`stream`
  Um resource de ponteiro do sistema de arquivos que normalmente é criado usando fopen().

### Valor Retornado

Retorna um array com as estatísticas de um arquivo. O formato do array é descrito em detalhes na página do manual sobre stat(). Returns `false` on failure.

### Exemplos

Exemplo #1 Exemplo fstat()

    <?php

    // abre um arquivo
    $fp = fopen("/etc/passwd", "r");

    // colhe as estatísticas
    $fstat = fstat($fp);

    // fecha o arquivo
    fclose($fp);

    // imprime somente a parte de índices associativos
    print_r(array_slice($fstat, 13));

    ?>

O exemplo acima produzirá algo semelhante a:

    Array
    (
        [dev] => 771
        [ino] => 488704
        [mode] => 33188
        [nlink] => 1
        [uid] => 0
        [gid] => 0
        [rdev] => 0
        [size] => 1114
        [atime] => 1061067181
        [mtime] => 1056136526
        [ctime] => 1056136526
        [blksize] => 4096
        [blocks] => 8
    )

### Notas

> Nota: Esta função não funcionará em arquivos remotos, pois o arquivo a ser examinado deve ser acessível através do sistema de arquivos do servidor.

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open