Класс RedisEngine
Движок Redis для кэширования.
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\RedisEngine
Краткое описание свойств
-
$_RedisprotectedОбёртка Redis.Redis -
$_defaultConfigprotectedКонфигурация по умолчанию, если не переопределена в конфигурации runtimearray
Унаследованные свойства
Краткое описание методов
- __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.
Параметры
- строка
$key - Идентификатор данных.
- смешанный
$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 )
Увеличивает значение группы, чтобы симулировать удаление всех ключей в группе. Старые значения остаются в хранилище до истечения срока действия.
Параметры
- строка
$group - имя группы для очистки
Возвращает
booleanуспех
Переопределяет
Cake\Cache\CacheEngine::clearGroup() decrement()source public
decrement( string $key , integer $offset = 1 )
Уменьшение значения целочисленного кэшированного ключа и обновление срока действия
Параметры
- строка
$key - Идентификатор данных
- целое число
$offsetнеобязательно 1 - На сколько уменьшить
Возвращает
boolean|целое числоНовое уменьшенное значение, false в противном случае
delete()source public
delete( string $key )
Удаление ключа из кэша
Параметры
- строка
$key - Идентификатор данных
Возвращает
booleanTrue, если значение было успешно удалено, false, если его не было или не удалось удалить
groups()source public
groups( )
Возвращает значения group value для каждой из настроенных групп. Если начальное значение группы не найдено, оно инициализируется соответствующим образом.
Возвращает
массивПереопределяет
Cake\Cache\CacheEngine::groups() increment()source public
increment( string $key , integer $offset = 1 )
Увеличение значения целочисленного кэшированного ключа и обновление срока действия
Параметры
- строка
$key - Идентификатор данных
- целое число
$offsetнеобязательно 1 - На сколько увеличить
Возвращает
boolean|целое числоНовое увеличенное значение, false в противном случае
init()source public
init( array $config = [] )
Инициализация движка кэша
Вызывается автоматически фронтэндом кэша
Параметры
- массив
$configнеобязательно [] - массив настроек для движка
Возвращает
booleanTrue, если движок успешно инициализирован, false в противном случае
Переопределяет
Cake\Cache\CacheEngine::init() read()source public
read( string $key )
Чтение ключа из кэша
Параметры
- строка
$key - Идентификатор данных
Возвращает
смешанныйКэшированные данные или false, если данные не существуют, срок действия истек или произошла ошибка при их извлечении
write()source public
write( string $key , mixed $value )
Запись данных для ключа в кэш.
Параметры
- строка
$key - Идентификатор данных
- смешанный
$value - Данные для кэширования
Возвращает
booleanTrue, если данные успешно кэшированы, false в противном случае
Унаследованные методы от Cake\Cache\CacheEngine
_key()source protected
_key( string $key )
Генерирует безопасный ключ, учитывая настроенный префикс ключа
Параметры
- строка
$key - переданный ключ
Возвращает
смешанныйстрока $key или ложь
Вызывает исключение
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 - переданный ключ
Возвращает
логическое значение|строкастрока ключа или ложь
readMany()source public
readMany( array $keys )
Чтение нескольких ключей из кэша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращает
массивДля каждого ключа кэша (указанного в качестве ключа массива) данные кэша, связанные с ним, или false, если данные не существуют, истекли или произошла ошибка при их извлечении
warning()source protected
warning( string $message )
Движки кэша могут вызывать предупреждения, если они сталкиваются с ошибками во время работы, если опция warnOnWriteFailures установлена в значение true.
Параметры
- строка
$message - Сообщение об ошибке.
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 - Значение для записи.
- логическое значение|строка
$mergeнеобязательный false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Вызывает исключение
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
config()source public deprecated
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 - Значение для установки.
- логическое значение
$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 - Значение для установки.
- логическое значение
$mergeнеобязательный true - Рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Вызывает исключение
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробности свойств
$_defaultConfigsource
protected array
Значения по умолчанию конфигурации, если не переопределены в конфигурации выполнения
-
databaseномер базы данных для подключения. -
durationУказывает, как долго элементы в этой конфигурации кеша остаются действительными. -
groupsСписок групп или 'тегов', связанных с каждым ключом, хранящимся в этой конфигурации. Полезно для удаления целой группы из кеша. -
passwordПароль сервера Redis. -
persistentПодключение к серверу Redis с постоянным соединением -
portномер порта сервера Redis. -
prefixПрефикс, добавляемый ко всем записям. Полезно, когда необходимо использовать один и тот же адрес ключей с другой конфигурацией кеша или другим приложением. -
probabilityВероятность запуска очистки кеша gc. Установка значения 0 отключит автоматический вызов cache::gc. -
serverURL или IP-адрес хоста сервера Redis. -
timeoutтаймаут в секундах (вещественное число). -
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–present 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.7/class-Cake.Cache.Engine.RedisEngine.html