Класс FileEngine
Движок файловой системы для кэша. Файловое хранилище — это самый медленный способ чтения и записи в кэш. Однако он подходит для серверов, у которых нет других доступных движков хранения или содержимое которых не является чувствительным к производительности.
Вы можете настроить кэш FileEngine, используя Cache::config()
- CacheEngine
-
FileEngine
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://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 - Создавать ключ, если он не существует, или нет
Возвращаемое значение
booleanистина, если ключ кэша был установлен, иначе ложь
add()source public
add( string $key , mixed $value , integer $duration )
Записать данные для ключа в кэш, если они ещё не существуют. Если они уже существуют, операция завершается с ошибкой и возвращает false.
Параметры
- строка
$key - Идентификатор данных.
- смешанные
$value - Данные, которые нужно кэшировать.
- целое число
$duration - Сколько времени данные нужно кэшировать, в секундах.
Возвращаемое значение
booleanИстина, если данные были успешно кэшированы, ложь при ошибке.
Переопределяет
CacheEngine::add() clear()source public
clear( boolean $check )
Удалить все значения из кэша
Параметры
- логическое значение
$check - Необязательно - удалить только истекшие элементы кэша
Возвращаемое значение
booleanИстина, если кэш был успешно очищен, ложь в противном случае
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 - Идентификатор данных
Возвращаемое значение
booleanИстина, если значение было успешно удалено, ложь, если оно не существовало или не могло быть удалено
gc()source public
gc( integer $expires null )
Сбор мусора. Постоянно удаляет все истекшие и удалённые данные
Параметры
- целое число
$expiresнеобязательно null - [необязательно] Метка времени истечения срока действия, делающая все данные до неё недействительными.
Возвращаемое значение
booleanИстина, если сбор мусора прошёл успешно, ложь при ошибке
Переопределяет
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 = массив());
Параметры
- массив
$settingsнеобязательно массив() - массив настроек для движка
Возвращаемое значение
booleanИстина, если движок был успешно инициализирован, ложь в противном случае
Переопределяет
CacheEngine::init() key()source public
key( string $key )
Генерирует безопасный ключ для использования с движками хранения кеша.
Параметры
- строка
$key - переданный ключ
Возвращает
mixedстрока $key или false
Переопределяет
CacheEngine::key() read()source public
read( string $key )
Чтение ключа из кеша
Параметры
- строка
$key - Идентификатор данных
Возвращает
mixedДанные кеша или false, если данные не существуют, истекли или произошла ошибка при их извлечении
write()source public
write( string $key , mixed $data , integer $duration )
Запись данных для ключа в кеш
Параметры
- строка
$key - Идентификатор данных
- mixed
$data - Данные для кеширования
- целое число
$duration - Срок хранения данных в секундах
Возвращает
booleanTrue, если данные были успешно сохранены в кеше, false в случае ошибки
Методы, унаследованные от CacheEngine
groups()source public
groups( )
Выполняет необходимые начальные действия для каждой группы и возвращает group value для каждой из них, это маркер, представляющий каждую группу в ключе кеша
Возвращает
arrayПодробности свойств
$settingssource
public array
Настройки
- путь = абсолютный путь к каталогу кеша, по умолчанию => CACHE
- префикс = строковый префикс для имени файла, по умолчанию => cake_
- блокировка = включить блокировку файла при записи, по умолчанию => true
- сериализация = сериализовать данные, по умолчанию => true
См. также
CacheEngine::__defaultsarray()
© 2005–2017 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.10/class-FileEngine.html