(PHP 4, PHP 5, PHP 7, PHP 8)
clearstatcache — 清除文件狀態(tài)緩存
$clear_realpath_cache = false, string $filename = ?): void當使用 stat()，lstat() 或者任何列在受影響函數表（見(jiàn)下面）中的函數時(shí)，PHP 將緩存這些函數的返回信息以提供更快的性能。然而在某些情況下，你可能想清除被緩存的信息。例如如果在一個(gè)腳本中多次檢查同一個(gè)文件，而該文件在此腳本執行期間有被刪除或修改的危險時(shí)，你需要清除文件狀態(tài)緩存。這種情況下，可以用 clearstatcache() 函數來(lái)清除被 PHP 緩存的該文件信息。
必須注意的是，對于不存在的文件，PHP 并不會(huì )緩存其信息。所以如果調用
file_exists() 來(lái)檢查不存在的文件，在該文件沒(méi)有被創(chuàng )建之前，它都會(huì )返回
false。如果該文件被創(chuàng )建了，就算以后被刪除，它都會(huì )返回 true
函數 unlink() 會(huì )自動(dòng)清除該緩存.
注意:
本函數緩存特定文件名的信息，因此只在對同一個(gè)文件名進(jìn)行多次操作并且需要該文件信息不被緩存時(shí)才需要調用 clearstatcache()。
受影響的函數包括 stat()， lstat()， file_exists()， is_writable()， is_readable()， is_executable()， is_file()， is_dir()， is_link()， filectime()， fileatime()， filemtime()， fileinode()， filegroup()， fileowner()， filesize()， filetype() 和 fileperms()。
clear_realpath_cache是否清除真實(shí)路徑緩存
filename
清除文件名指定的文件的真實(shí)路徑緩存; 只在
clear_realpath_cache 為 true
時(shí)啟用
沒(méi)有返回值。
| 版本 | 說(shuō)明 |
|---|---|
| 5.3.0 |
增加了可選的 clear_realpath_cache
和 filename 參數.
|
示例 #1 clearstatcache() 例子
<?php
$file = 'output_log.txt';
function get_owner($file)
{
$stat = stat($file);
$user = posix_getpwuid($stat['uid']);
return $user['name'];
}
$format = "UID @ %s: %s\n";
printf($format, date('r'), get_owner($file));
chown($file, 'ross');
printf($format, date('r'), get_owner($file));
clearstatcache();
printf($format, date('r'), get_owner($file));
?>
以上例程的輸出類(lèi)似于：
UID @ Sun, 12 Oct 2008 20:48:28 +0100: root UID @ Sun, 12 Oct 2008 20:48:28 +0100: root UID @ Sun, 12 Oct 2008 20:48:28 +0100: ross