函式名:clearstatcache()
適用版本:PHP 4 >= 4.0.0, PHP 5, PHP 7
函式描述:clearstatcache() 函式用於清除檔案狀態快取,使檔案狀態資訊更加準確。
用法:
clearstatcache(bool $clear_realpath_cache = false, string $filename = '')
引數說明:
$clear_realpath_cache(可選):指定是否清除 realpath 快取,預設為 false,表示不清除。如果該引數設定為 true,則會清除 realpath 快取。
$filename(可選):指定需要清除狀態快取的檔案路徑。若提供了該引數,則只會清除指定檔案的狀態快取;若未提供該引數,則會清除全部檔案的狀態快取。
返回值:無返回值。
示例:
- 示例一:清除全部檔案的狀態快取
<?php
clearstatcache();
?>
- 示例二:清除指定檔案的狀態快取
<?php
clearstatcache(false, '/path/to/file.txt');
?>
- 示例三:清除 realpath 快取,並清除指定檔案的狀態快取
<?php
clearstatcache(true, '/path/to/file.txt');
?>
注意事項:
- 由於 PHP 在內部會自動更新檔案狀態快取,因此在絕大多數情況下並不需要手動呼叫 clearstatcache() 函式。
- 如果你需要獲取最新的檔案狀態資訊,可以在呼叫 stat()、file_exists()、is_readable() 等函式之前,先呼叫 clearstatcache() 函式,從而確保獲取的狀態資訊是最新的。