(PHP 4, PHP 5)
clearstatcache — Изчиства кеша за статуса на файл
Когато използвате функциите stat(), lstat() или някоя от другите функции изброени по-долу PHP кешира информацията, която тези функции връщат с цел да осигури по-добра производителност. В някой случаи обаче може да искате да изчистите този кеш. Да вземем следния пример: скрипт проверява статуса на даден файл на няколко пъти в процеса на изпълнение, но има вероятност в някой момент този файл да бъде изтрит или променен. В такъв случай можете да използвате функцията clearstatcache(), за да изчистите кеша за статуса.
Трябва също така да се отбележи, че PHP не кешира информация за несъществуващи файлове, т.е. ако извикате file_exists() за несъществуващ файл тя ще върне FALSE. Когато създадете файла file_exists() ще връща TRUE докато не изтриете файла (т.е. няма нужда да извиквате clearstatcache() между проверките за съществуване на файла). Както може да се предположи при изтриване unlink() изчиства кеша автоматично.
Забележка: Тази функция кешира информацията за специфични файлове, така че трябва да извикате clearstatcache() само ако изпълнявате множество операции върху един и същ файл и изисквате информацията за този файл да не се кешира.
Списък на функциите, които създават кеш за статуса на файлове и които се засягат от действието на clearstatcache(): lstat(), file_exists(), is_writable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype(), и fileperms().
Дали да изчити кеша на realpath или не (по подразбиране е FALSE)
Изчиства кеша на realpath за дадено име на файл. Използва се само ако clear_realpath_cache е TRUE.
Няма връщана стойност.
Версия | Описание |
---|---|
5.3.0 | Добавени са допълнителни параметри clear_realpath_cache и filename . |
Example #1 Пример за използване на clearstatcache()
<?php
$file = 'output_log.txt';
function get_owner($file)
{
$stat = stat($file);
$user = posix_getpwuid($s['uid']);
return $user['name'];
}
$format = "UID @ %s: %s\n";
printf($format, date('r'), get_owner($file));
chown($path, 'ross');
printf($format, date('r'), get_owner($file));
clearstatcache();
printf($format, date('r'), get_owner($file));
?>
Примерът по-горе ще изведе нещо подобно на:
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