void clearstatcache(void);stat または lstat システムコールは、ほとんどのシステムにおいて かなりのコストがかかるものです。そのため、ステータス関連の関数 （後述）への最後のコールの結果はキャッシュされ、同名のファイル に対する同じような関数コールに際してそのキャッシュが使われます。 もし新たなステータスチェックを強制したい場合、たとえばファイルが 何度もチェックされ、その間に変更されたり消えたりする可能性がある 場合、この関数をコールすることにより最後のコールの結果がメモリから クリアされます。
単一のリクエストが持続している間のみ、この値のキャッシュが 行われます。
影響を受ける関数を以下に示します。 lstat, stat, file_exists, is_writeable, is_readable, is_executable, is_file, is_dir, is_link, filectime, fileatime, filemtime, fileinode, filegroup, fileowner, filesize, filetype, fileperms