(PHP 4, PHP 5)
clearstatcache — Limpia la cache de estado de un archivo
Cuando se usa stat(), lstat(), o cualquier otra de las funciones en la lista de funciones afectadas (vea abajo), PHP pone en cache la información de lo que devuelven esas funciones, en aras de proveer mayor desempeño. Sin embargo, en ciertos casos, tal vez desee quitar la información en el cache. Por ejemplo, si el mismo archivo está siendo revisado muchas veces dentro de un mismo script, y ese archivo está en peligro de ser removido o cambia durante la operación del script, puede escoger borrar el cache. En estos casos, puede usar la función clearstatcache() para limpiar la información que PHP pone en cache acerca del archivo.
Debe notar también que PHP no pone información en cache de archivos que no existen. De tal manera, que si ejecuta file_exists() en un archivo que no existe, regresará FALSE hasta que cree el archivo. SI crea el archivo, regresará TRUE aunque haya borrado el archivo.
Note: Esta función pone en cache información acerca de nombres de archivo especificos, de tal forma que solo necesita ejecutar clearstatcache() si está elaborando operaciones múltiples sobre el mismo archivo y necesita que la información sobre un archivo en particular no se ponga en cache.
Entre las funciones afectadas se incluyen stat(), lstat(), file_exists(), is_writeable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype(), y fileperms().