clearstatcache

(PHP 4, PHP 5, PHP 7, PHP 8)

clearstatcacheLimpia la caché de estado de un archivo

Descripción

clearstatcache(bool$clear_realpath_cache = false, string$filename = ?): void

Cuando 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().

Parámetros

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.

Valores devueltos

No devuelve ningún valor.

Historial de cambios

VersiónDescripción
5.3.0 Se añadieron los parámetros opcionales clear_realpath_cache y filename.

Ejemplos

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
To Top