Класс FileEngine
Двигатель хранения файлов для кэша. Хранилище файлов — это самое медленное хранилище кэша для чтения и записи. Однако оно подходит для серверов, на которых нет другого хранилища, или для контента, для которого не важна производительность.
Вы можете настроить кэш FileEngine, используя Cache::config()
- CacheEngine
-
FileEngine
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Cache/Engine/FileEngine.php
Краткое описание свойств
- Экземпляр класса SplFileObject
$_Fileprotected -
$_initprotectedИстина, если FileEngine::__active(); выполняется успешноboolean -
$settingspublicНастройкиarray
Унаследованные свойства
Краткое описание методов
- _active() protectedОпределяет, является ли каталог кэша доступным для записи
- _clearDirectory() protectedИспользуется для удаления файлов, соответствующих шаблону, из каталога.
- _setKey() protected
Устанавливает текущий ключ кэша, который управляет этим классом, и создает доступный для записи SplFileObject для файла кэша, на который ссылается ключ.
- add() public
Записывает данные для ключа в кэш, если они еще не существуют. Если они уже существуют, операция завершается с ошибкой и возвращает false.
- clear() publicУдаляет все значения из кэша
- clearGroup() publicРекурсивно удаляет все файлы в каталоге с именем $group
- decrement() publicНе реализовано
- delete() publicУдаляет ключ из кэша
- gc() publicСбор мусора. Постоянно удаляет все устаревшие и удаленные данные
- increment() publicНе реализовано
- init() publicИнициализирует движок кэша
- key() publicГенерирует безопасный ключ для использования с движками хранения кэша.
- read() publicСчитывает ключ из кэша
- write() publicЗаписывает данные для ключа в кэш
Подробное описание методов
_active()source protected
_active( )
Определяет, является ли каталог кэша доступным для записи
Возвращает
boolean_clearDirectory()source protected
_clearDirectory( string $path , integer $now , integer $threshold )
Используется для очистки каталога от соответствующих файлов.
Параметры
- строка
$path - Путь для поиска.
- целое число
$now - Текущая метка времени
- целое число
$threshold - Любой файл, не измененный после этого значения, будет удален.
_setKey()source protected
_setKey( string $key , boolean $createKey false )
Устанавливает текущий ключ кэша, который управляет этим классом, и создает доступный для записи SplFileObject для файла кэша, на который ссылается ключ.
Параметры
- строка
$key - Ключ
- логическое значение
$createKeyопционально false - Указывает, должен ли создаваться ключ, если он не существует
Возвращает
booleantrue, если ключ кэша был установлен, иначе false
add()source public
add( string $key , mixed $value , integer $duration )
Записывает данные для ключа в кэш, если они еще не существуют. Если они уже существуют, операция завершается с ошибкой и возвращает false.
Параметры
- строка
$key - Идентификатор данных.
- смешанный тип
$value - Данные для кэширования.
- целое число
$duration - Срок хранения данных в секундах.
Возвращает
booleanTrue, если данные были успешно кэшированы, false в случае неудачи.
Переопределяет
CacheEngine::add() clear()source public
clear( boolean $check )
Удаляет все значения из кэша
Параметры
- логическое значение
$check - Опционально - удалять только истекшие элементы кэша
Возвращает
booleanTrue, если кэш был успешно очищен, иначе false
clearGroup()source public
clearGroup( string $group )
Рекурсивно удаляет все файлы в каталоге с именем $group
Параметры
- строка
$group - Группа для очистки.
Возвращает
booleanуспех
Переопределяет
CacheEngine::clearGroup() decrement()source public
decrement( string $key , integer $offset 1 )
Не реализовано
Параметры
- строка
$key - Ключ для декремента
- целое число
$offsetопционально 1 - Значение для вычитания
Исключения
CacheExceptiondelete()source public
delete( string $key )
Удаляет ключ из кэша
Параметры
- строка
$key - Идентификатор данных
Возвращает
booleanTrue, если значение было успешно удалено, false, если его не существовало или его нельзя было удалить
gc()source public
gc( integer $expires null )
Сбор мусора. Постоянно удаляет все устаревшие и удаленные данные
Параметры
- целое число
$expiresопционально null - [опционально] Метка времени истечения срока действия, аннулирующая все данные до этого значения.
Возвращает
booleanTrue, если сбор мусора выполнен успешно, иначе false
Переопределяет
CacheEngine::gc() increment()source public
increment( string $key , integer $offset 1 )
Не реализовано
Параметры
- строка
$key - Ключ для инкремента
- целое число
$offsetопционально 1 - Значение для прибавления
Исключения
CacheExceptioninit()source public
init( array $settings array() )
Инициализирует движок кэша
Вызывается автоматически интерфейсом кэша. Для повторной инициализации настроек вызовите Cache::engine('EngineName', [опционально] settings = array());
Параметры
- массив
$settingsопционально array() - массив настроек для движка
Возвращает
booleanTrue, если движок был успешно инициализирован, иначе false
Переопределяет
CacheEngine::init() key()source public
key( string $key )
Генерирует безопасный ключ для использования с хранилищами кеша.
Параметры
- строка
$key - переданный ключ
Возвращает
смешанныйстрока $key или false
Переопределяет
CacheEngine::key() read()source public
read( string $key )
Чтение ключа из кэша
Параметры
- строка
$key - Идентификатор данных
Возвращает
смешанныйДанные из кэша или false, если данных нет, они истекли или произошла ошибка при их получении
write()source public
write( string $key , mixed $data , integer $duration )
Запись данных для ключа в кэш
Параметры
- строка
$key - Идентификатор данных
- смешанный
$data - Данные, которые нужно поместить в кэш
- целое число
$duration - Время хранения данных в секундах
Возвращает
booleanTrue, если данные успешно помещены в кэш, false — при ошибке
Наследуемые методы из CacheEngine
groups()source public
groups( )
Выполняет необходимые действия инициализации для каждой группы и возвращает group value для каждой из них, это маркер, представляющий каждую группу в ключе кэша
Возвращает
массивПодробности свойств
$settingssource
public массив
Настройки
- path = абсолютный путь к каталогу кэша, по умолчанию => CACHE
- prefix = префикс для имени файла, по умолчанию => cake_
- lock = включить блокировку файла при записи, по умолчанию => true
- serialize = сериализовать данные, по умолчанию => true
См. также
CacheEngine::__defaultsarray()
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/2.9/class-FileEngine.html