(PHP 4, PHP 5, PHP 7)
clearstatcache — Limpia la caché de estado de un archivo
$clear_realpath_cache
= false
[, string $filename
]] ) : voidCuando usa stat(), lstat(), o cualquier otra función enumerada en la lista de funciones afectadas (abajo), PHP examina la información que devuelven esas funciones para proporcionar un rendimiento más rápido. Sin embargo, en ciertos casos, puede querer 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.
Debería observar también que PHP no examina información sobre archivos no
existentes. Por lo que si llama a file_exists() con un archivo que
no existe, se devolverá FALSE
a menos que cree el archivo. Si crea
el archivo, se devolverá TRUE
incluso si después borra el archivo.
Sin embargo unlink() limpia la caché automáticamente.
Nota:
Esta función examina la información sobre nombres de archivos específicos, por lo que sólo necesita llamar a clearstatcache() si está llevando a cabo múltiples operaciones sobre un mismo nombre de archivo y necesita que la información sobre ese archivo en particular no sea examinada.
Las funciones afectadas incluyen stat(), lstat(), file_exists(), is_writable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype(), y fileperms().
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
.
No devuelve ningún valor.
Versión | Descripción |
---|---|
5.3.0 |
Se añadieron los parámetros opcionales clear_realpath_cache
y filename .
|
Ejemplo #1 Ejemplo de clearstatcache()
<?php
$archivo = 'output_log.txt';
function obtener_propietario($archivo)
{
$estadísticas = stat($archivo);
$usuario = posix_getpwuid($estadísticas['uid']);
return $usuario['name'];
}
$formato = "UID @ %s: %s\n";
printf($formato, date('r'), obtener_propietario($archivo));
chown($archivo, 'ross');
printf($formato, date('r'), obtener_propietario($archivo));
clearstatcache();
printf($formato, date('r'), obtener_propietario($archivo));
?>
El resultado del ejemplo sería algo similar a:
UID @ Sun, 12 Oct 2008 20:48:28 +0100: root UID @ Sun, 12 Oct 2008 20:48:28 +0100: root UID @ Sun, 12 Oct 2008 20:48:28 +0100: ross