php8.5
Home/ Manual/ filesystem / functions/ fstat

fstat

PHP function Edit on GitHub ✎

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

Gets information about a file using an open file pointer

Description

fstat(resource $stream): array|false

Gathers the statistics of the file opened by the file pointer stream. This function is similar to the stat() function except that it operates on an open file pointer instead of a filename.

Parameters

stream

Pointer

Return Values

Returns an array with the statistics of the file; the format of the array is described in detail on the stat() manual page. Returns false on failure.

Examples

fstat() example

php
<?php

// open a file
$fp = fopen("/etc/passwd", "r");

// gather statistics
$fstat = fstat($fp);

// close the file
fclose($fp);

// print only the associative part
print_r(array_slice($fstat, 13));

?>

The above example will output something similar to:

output
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
)

Notes No-remote

Source: reference/filesystem/functions/fstat.xml · from the official PHP manual (php/doc-en)