Класс WincacheEngine
Двигатель хранилища Wincache для кэша
Поддерживает wincache 1.1.0 и выше.
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\WincacheEngine
Краткое описание свойств
-
$_compiledGroupNamesprotectedarrayСодержит скомпилированные имена групп (с префиксом глобального префикса конфигурации)
Наследованные свойства
Краткое описание методов
- clear() public
Удаляет все ключи из кэша. Это очистит каждый элемент в кэше, соответствующий префиксу конфигурации кэша.
- clearGroup() public
Увеличивает значение группы, чтобы смоделировать удаление всех ключей в группе. Старые значения останутся в хранилище до их истечения срока действия.
- decrement() publicУменьшает значение целочисленного кэшированного ключа
- delete() publicУдаляет ключ из кэша
- groups() public
Возвращает
group valueдля каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответствующим образом. - increment() publicУвеличивает значение целочисленного кэшированного ключа
- init() publicИнициализировать движок кэша
- read() publicСчитывает ключ из кэша
- write() publicЗаписывает данные для ключа в кэш
Подробное описание методов
clear()source public
clear( boolean $check )
Удаляет все ключи из кэша. Это очистит каждый элемент в кэше, соответствующий префиксу конфигурации кэша.
Параметры
- boolean
$check Если true, ничего не будет очищено, так как записи естественным образом истекают в wincache.
Возвращаемое значение
booleanTrue Возвращает true.
clearGroup()source public
clearGroup( string $group )
Увеличивает значение группы, чтобы смоделировать удаление всех ключей в группе. Старые значения останутся в хранилище до их истечения срока действия.
Параметры
- string
$group - Группа для очистки.
Возвращаемое значение
booleanуспех
Переопределяет
Cake\Cache\CacheEngine::clearGroup() decrement()source public
decrement( string $key , integer $offset 1 )
Уменьшает значение целочисленного кэшированного ключа
Параметры
- string
$key - Идентификатор данных
- integer
$offsetнеобязательно 1 - На сколько уменьшить
Возвращаемое значение
boolean|integerНовое уменьшенное значение, иначе false
delete()source public
delete( string $key )
Удаляет ключ из кэша
Параметры
- string
$key - Идентификатор данных
Возвращаемое значение
booleanTrue, если значение было успешно удалено, false, если его не существовало или не удалось удалить
groups()source public
groups( )
Возвращает group value для каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответствующим образом.
Возвращаемое значение
arrayПереопределяет
Cake\Cache\CacheEngine::groups() increment()source public
increment( string $key , integer $offset 1 )
Увеличивает значение целочисленного кэшированного ключа
Параметры
- string
$key - Идентификатор данных
- integer
$offsetнеобязательно 1 - На сколько увеличить
Возвращаемое значение
boolean|integerНовое увеличенное значение, иначе false
init()source public
init( array $config [] )
Инициализировать движок кэша
Вызывается автоматически передним фронтэнд кэша
Параметры
- array
$configнеобязательно [] - массив настроек для движка
Возвращаемое значение
booleanTrue, если движок был успешно инициализирован, иначе false
Переопределяет
Cake\Cache\CacheEngine::init() read()source public
read( string $key )
Считывает ключ из кэша
Параметры
- string
$key - Идентификатор данных
Возвращаемое значение
mixedКэшированные данные или false, если данные не существуют, истекли или при возникновении ошибки при их извлечении
write()source public
write( string $key , mixed $value )
Записывает данные для ключа в кэш
Параметры
- string
$key - Идентификатор данных
- mixed
$value - Данные для кэширования
Возвращаемое значение
booleanTrue, если данные были успешно кэшированы, false при ошибке
Методы, унаследованные от Cake\Cache\CacheEngine
_key()source protected
_key( string $key )
Генерирует безопасный ключ, учитывая настроенный префикс ключа
Параметры
- string
$key - переданный ключ
Возвращаемое значение
mixedстрока $key или false
Исключения
InvalidArgumentExceptionЕсли значение ключа пустое
add()source public
add( string $key , mixed $value )
Добавляет ключ в кэш, если он еще не существует.
По умолчанию используется неатомарная реализация. Подклассы должны отдавать предпочтение атомарным реализациям.
Параметры
- string
$key - Идентификатор данных.
- mixed
$value - Данные для кэширования.
Возвращаемое значение
booleanTrue, если данные были успешно кэшированы, false при ошибке.
deleteMany()source public
deleteMany( array $keys )
Удаляет ключи из кэша
Параметры
- array
$keys - Массив идентификаторов данных
Возвращаемое значение
arrayДля каждого предоставленного ключа кэша (возвращаемого в качестве ключа массива) true, если значение было успешно удалено, false, если его не существовало или не удалось удалить
gc()source public
gc( integer|null $expires null )
Сбор мусора
Постоянно удаляет все просроченные и удаленные данные
Параметры
- integer|null
$expiresнеобязательно null - [необязательно] Марка времени истечения срока действия, делающая все данные недействительными до нее.
key()source public
key( string $key )
Генерирует безопасный ключ для использования с движками хранения кэша.
Параметры
- строка
$key - переданный ключ
Возвращает
boolean|stringключ или ложь
readMany()source public
readMany( array $keys )
Чтение нескольких ключей из кэша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращает
массивДля каждого ключа кэша (указанного в качестве ключа массива) соответствующие данные кэша или ложь, если данных нет, они истекли или произошла ошибка при их извлечении
writeMany()source public
writeMany( array $data )
Запись данных для многих ключей в кэш
Параметры
- массив
$data - Массив данных для хранения в кэше
Возвращает
массивзначений булевого типа для каждого предоставленного ключа, true, если данные успешно сохранены в кэше, false в случае ошибки
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет один ключ конфигурации.
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionесли происходит попытка перезаписи существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Читает ключ конфигурации.
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
смешанный тип_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записывает ключ конфигурации.
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный тип
$value - Значение для записи.
- boolean|строка
$mergeопционально false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию — false.
Исключения
Cake\Core\Exception\Exceptionесли происходит попытка перезаписи существующей конфигурации
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Получение/Установка конфигурации.
Использование
Чтение всей конфигурации:
$this->config();
Чтение определенного значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определенного значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Устаревшее
3.4.0 использовать setConfig()/getConfig() вместо этого.Параметры
- строка|массив|null
$keyопционально null - Ключ для получения/установки или весь массив конфигурации.
- смешанный тип|null
$valueопционально null - Значение для установки.
- boolean
$mergeопционально true - Рекурсивное слияние или перезапись существующей конфигурации, по умолчанию — true.
Возвращает
смешанный типЗначение конфигурации для чтения или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Объединение предоставленной конфигурации с существующей конфигурацией. В отличие от config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определенного значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или весь массив конфигурации.
- смешанный тип|null
$valueопционально null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- строка|null
$keyопционально null - Ключ для получения или null для всей конфигурации.
- смешанный тип
$defaultопционально null - Возвращаемое значение, если ключ не существует.
Возвращает
смешанный типЗначение конфигурации для чтения.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или весь массив конфигурации.
- смешанный тип|null
$valueопционально null - Значение для установки.
- boolean
$mergeопционально true - Рекурсивное слияние или перезапись существующей конфигурации, по умолчанию — true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробное описание свойств
$_compiledGroupNamessource
protected массив
Содержит скомпилированные имена групп (с префиксом из глобальной конфигурации)
[]
© 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/3.4/class-Cake.Cache.Engine.WincacheEngine.html