Класс RedisEngine
Двигатель Redis для кеширования.
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\RedisEngine
Краткое описание свойств
-
$_RedisprotectedОбёртка над Redis.Redis -
$_defaultConfigprotectedКонфигурация по умолчанию, используемая, если не переопределена конфигурацией во время выполнения.array
Наследованные свойства
Краткое описание методов
- __destruct() publicОтключение от сервера redis
- _connect() protectedПодключение к серверу Redis
- add() public
Запись данных для ключа в кеш, если ключ ещё не существует. В противном случае, операция завершается неудачей и возвращается false.
- clear() publicУдаление всех ключей из кеша
- clearGroup() public
Увеличивает значение группы для имитации удаления всех ключей в группе. Старые значения останутся в хранилище до тех пор, пока они не истекут.
- decrement() publicУменьшение значения целочисленного кешированного ключа
- delete() publicУдаление ключа из кеша
- groups() public
Возвращает значения
group valueдля каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответствующим образом. - increment() publicУвеличение значения целочисленного кешированного ключа
- init() publicИнициализация кеша
- read() publicЧтение ключа из кеша
- write() publicЗапись данных для ключа в кеш.
Подробное описание методов
_connect()source protected
_connect( )
Подключение к серверу Redis
Возвращает
booleanTrue, если сервер Redis подключён
add()source public
add( string $key , mixed $value )
Запись данных для ключа в кеш, если ключ ещё не существует. В противном случае, операция завершается неудачей и возвращается false.
Параметры
- string
$key - Идентификатор данных.
- mixed
$value - Данные для кеширования.
Возвращает
booleanTrue, если данные успешно кешированы, false в случае ошибки.
Ссылка
https://github.com/phpredis/phpredis#setnxПереопределяет
Cake\Cache\CacheEngine::add() clear()source public
clear( boolean $check )
Удаление всех ключей из кеша
Параметры
- boolean
$check - Если true, будет проверка истечения срока действия, в противном случае удаляются все.
Возвращает
booleanTrue, если кеш успешно очищен, false в противном случае
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Если значение ключа пустое
deleteMany()source public
deleteMany( array $keys )
Удаляет ключи из кэша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращаемые значения
массивДля каждого предоставленного ключа кэша (возвращаемого в качестве ключа массива) true, если значение было успешно удалено, false, если его не существовало или не удалось удалить
gc()source public
gc( integer|null $expires null )
Сбор мусора
Постоянно удаляет все устаревшие и удалённые данные
Параметры
- целое число|null
$expiresнеобязательно null - [необязательно] Отметка времени истечения срока действия, аннулирующая все данные до неё.
key()source public
key( string $key )
Генерирует безопасный ключ для использования с движками хранения кэша.
Параметры
- строка
$key - переданный ключ
Возвращаемые значения
boolean|строкаключ строки или false
readMany()source public
readMany( array $keys )
Чтение нескольких ключей из кэша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращаемые значения
массивДля каждого ключа кэша (указанного как ключ массива) данные кэша, связанные с ним, или false, если данные не существуют, истекли или произошла ошибка при их извлечении
writeMany()source public
writeMany( array $data )
Запись данных для многих ключей в кэш
Параметры
- массив
$data - Массив данных, которые нужно сохранить в кэше
Возвращаемые значения
массивзначений типа bool для каждого предоставленного ключа, 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']);
Параметры
- строка|массив|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->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
Возвращаемые значения
$this Сам объект.
Подробности свойств
$_defaultConfigsource
protected массив
Конфигурация по умолчанию, используемая, если не переопределена конфигурацией во время выполнения
-
databaseномер базы данных для подключения. -
durationУказывает, как долго элементы в этой конфигурации кэша хранятся. -
groupsСписок групп или «тегов», связанных с каждым ключом, сохраненным в этой конфигурации. Удобно для удаления всей группы из кэша. -
passwordПароль сервера Redis. -
persistentПодключение к серверу Redis с постоянным подключением -
portНомер порта сервера Redis. -
prefixПрефикс, добавляемый ко всем записям. Полезно, когда вам нужно использовать один и тот же пространство ключей с другой конфигурацией кэша или другим приложением. -
probabilityВероятность запуска автоматической очистки кэша gc. Установка в 0 отключит автоматический вызов cache::gc. -
serverURL или IP-адрес хоста сервера Redis. -
timeoutВремя ожидания в секундах (float). -
unix_socketПуть к файлу unix-соккета (по умолчанию: false)
[
'database' => 0,
'duration' => 3600,
'groups' => [],
'password' => false,
'persistent' => true,
'port' => 6379,
'prefix' => 'cake_',
'probability' => 100,
'host' => null,
'server' => '127.0.0.1',
'timeout' => 0,
'unix_socket' => false,
]
© 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.3/class-Cake.Cache.Engine.RedisEngine.html