Класс FileEngine
Движок хранения файлов для кеша. Filestorage — это самое медленное хранилище кеша для чтения и записи. Однако он подходит для серверов, у которых нет других доступных хранилищ, или для контента, чувствительность которого к производительности невысока.
Вы можете настроить кеш 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 - Указывает, нужно ли создавать ключ, если он не существует
Возвращает
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 = array());
Параметры
- массив
$settingsдополнительно array() - массив настроек для движка
Возвращает
booleanИстина, если движок был успешно инициализирован, ложь в противном случае
Переопределяет
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.
http://api.cakephp.org/2.8/class-FileEngine.html