Función clearstatcache() en PHP

Función clearstatcache()

Limpia la caché de estado de un archivo

Sintaxis

clearstatcache ( $clear_realpath_cache = false, $filename)

Cuando se usa stat(), lstat(), o cualquiera de las otras funciones mostrada en la lista de (funciones afectadas), PHP almacena en caché la información de esas funciones con el fin de proporcionar un rendimiento más rápido. Sin embargo, en ciertos casos, es posible que desee borrar la información almacenada en caché.
Por ejemplo, si el mismo archivo está siendo verificado múltiples veces dentro de un sólo script, y ese archivo corre el peligro de ser borrado o modificado durante la operación de ese script, puede optar por limpiar la caché de estado. En estos casos, puede usar la función clearstatcache() para borrar la información que PHP examina 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.

Nota: 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.

Las funciones que son el almacenamiento en caché:

stat ()
lstat ()
file_exists ()
is_writable ()
is_readable ()
is_executable ()
is_file ()
is_dir ()
is_link ()
filectime ()
fileatime ()
filemtime ()
fileinode ()
grupo de archivos ()
fileowner ()
filesize ()
filetype ()
fileperms ()

Veamos algunos ejemplos:

<?php
    //comprueba el tamaño del archivo
    echo filesize("test.txt");
    echo "<br />";

    $file = fopen("test.txt", "a+");
    // se trunca el archivo a una longitud dada
    ftruncate($file,100);
    fclose($file);

    //Se limpia cache y se comprueba el tamaño del archivo nuevamente
    clearstatcache();
    echo filesize("test.txt");
?>

El resultado que obtendremos será el siguiente

792
100

Parámetros

Parámetros	Descripción
clear_realpath_cache	Si se limpia la caché de la ruta real o no.
filename	Limpia la ruta real y la caché de estadísticas para un nombre de fichero específico; solamente se usa si clear_realpath_cache es TRUE.