PHP 檔案系統 fstat() 函式



PHP 檔案系統fstat()函式用於返回有關開啟檔案的資訊。此函式可以獲取由檔案指標控制代碼開啟的檔案的統計資訊。此函式類似於stat()函式,不同之處在於它可以操作開啟的檔案指標而不是檔名。

語法

以下是 PHP 檔案系統fstat()函式的語法:

array fstat ( resource $handle )

引數

使用fstat()函式所需的的引數如下:

序號 引數和描述
1

handle(必需)

這是一個使用fopen()開啟的檔案系統指標資源。

返回值

它返回一個包含檔案統計資訊的陣列,或者在失敗時返回 FALSE。

PHP 版本

fstat()函式最初作為核心 PHP 4 的一部分引入,並能與 PHP 5、PHP 7、PHP 8 良好地配合使用。

示例

在這個 PHP 程式碼中,我們將首先開啟一個檔案,使用 PHP 檔案系統fstat()函式檢索有關它的資訊,然後列印該資訊。

<?php
   $file = fopen("/PhpProject/sample.txt", "r");  
   
   //Use fstat() function
   print_r(fstat($file));
   fclose($file);
?>

輸出

以下是上述 PHP 程式碼的輸出:

Array
(
    [0] => 1245376677
    [1] => 12666373952223775
    [2] => 33206
    [3] => 1
    [4] => 0
    [5] => 0
    [6] => 0
    [7] => 49
    [8] => 1590217956
    [9] => 1590994836
    [10] => 1590217956
    [11] => -1
    [12] => -1
    [dev] => 1245376677
    [ino] => 12666373952223775
    [mode] => 33206
    [nlink] => 1
    [uid] => 0
    [gid] => 0
    [rdev] => 0
    [size] => 49
    [atime] => 1590217956
    [mtime] => 1590994836
    [ctime] => 1590217956
    [blksize] => -1
    [blocks] => -1
)

示例

此示例演示瞭如何使用fstat()函式獲取檔案的大小。

<?php
    $file = fopen("/PhpProject/sample.txt", "r");
    $file_info = fstat($file);
    $file_size = $file_info['size'];
    echo "File size: $file_size bytes";
    fclose($file);
?> 

輸出

這將產生以下結果:

File size: 104 bytes

示例

此示例演示瞭如何使用fstat()函式檢查檔案的許可權。

<?php
    $file = fopen("/PhpProject/sample.txt", "r");
    $file_info = fstat($file);
    $permissions = $file_info['mode'] & 0777; // Get permissions
    echo "File permissions: $permissions";
    fclose($file);
?> 

輸出

這將生成以下結果:

File permissions: 644

示例

此示例演示瞭如何使用fstat()函式查詢檔案的上次訪問時間。

<?php
    $file = fopen("/PhpProject/sample.txt", "r");
    $file_info = fstat($file);
    $last_access_time = $file_info['atime'];
    $last_access_readable = date("Y-m-d H:i:s", $last_access_time);
    echo "Last access time: $last_access_readable";
    fclose($file);
?> 

輸出

這將導致以下輸出:

Last access time: 2024-06-06 03:56:09

總結

PHP fstat()函式提供有關檔案的資訊,例如其大小和許可權。它的引數是一個檔案指標資源,有時透過使用fopen()開啟檔案來獲取。

php_function_reference.htm
廣告