lstat
(PHP 4, PHP 5, PHP 7, PHP 8)
lstat — 給出一個檔案或符號連線的資訊
說明
lstat(string
$filename): array
獲取由 filename 指定的檔案或符號連線的統計資訊。
參數
-
filename -
檔案或符號連線的路徑。
返回值
有關 lstat()
返回的陣列結構見手冊中 stat() 函式的頁面。
本函式和
stat() 函式相同，只除了如果
filename 參數是符號連線的話，則該符號連線的狀態被返回，而不是該符號連線所指向的檔案的狀態。
範例
示例 #1 stat() 和 lstat() 的對照
<?php
symlink('uploads.php', 'uploads');
// Contrast information for uploads.php and uploads
array_diff(stat('uploads'), lstat('uploads'));
?>
以上例程的輸出類似於：
Information that differs between the two files.
Array
(
[ino] => 97236376
[mode] => 33188
[size] => 34
[atime] => 1223580003
[mtime] => 1223581848
[ctime] => 1223581848
[blocks] => 8
)
錯誤／異常
失敗時拋出E_WARNING警告。
註釋
注意: 此函式的結果會被快取。參見 clearstatcache() 以獲得更多細節。
小技巧
自 PHP 5.0.0 起, 此函式也用於某些 URL 包裝器。請參見 支援的協議和封裝協議以獲得支援 stat() 系列函式功能的包裝器列表。