clearstatcache

(PHP 3, PHP 4, PHP 5)

clearstatcache -- 清除檔案狀態暫存

說明

void clearstatcache ( void )

當使用 stat()lstat() 或是任何列在受影響函數表(見下面)中的函數時,PHP 將暫存這些函數的返回訊息以提供更快的效能。然而在某些情況下,你可能想清除被暫存的訊息。例如若果在一個腳本中多次檢查同一個檔案,而該檔案在此腳本執行期間有被移除或修改的危險時,你需要清除檔案狀態暫存。這種情況下,可以用 clearstatcache() 函數來清除被 PHP 暫存的該檔案訊息。

必須注意的是,對於不存在的檔案,PHP 並不會暫存其訊息。所以若果呼叫 file_exists() 來檢查不存在的檔案,在該檔案沒有被建立之前,它都會返回 FALSE。若果該檔案被建立了,就算以後被移除,它都會返回 TRUE

注: 本函數暫存特定檔案名的訊息,因此只在對同一個檔案名進行多次動作並且需要該檔案訊息不被暫存時才需要呼叫 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()