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