Spec-Zone.ru › CakePHP 3.4

Класс RedisEngine

Движок Redis для кеширования.

Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
Extended by Cake\Cache\Engine\RedisEngine
Пространство имён: Cake\Cache\Engine
Расположение: Cache/Engine/RedisEngine.php

Краткое описание свойств

  • $_Redis protected
    Redis
    Обёртка над Redis.
  • $_defaultConfig protected
    array
    По умолчанию используется конфигурация, если она не переопределена конфигурацией во время выполнения.

Унаследованные свойства

  • _groupPrefix _config, _configInitialized

Краткое описание методов

  • __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
    Записывает данные для ключа в кеш.

Подробное описание методов

__destruct()source public

__destruct( )

Отключается от сервера Redis

_connect()source protected

_connect( )

Подключается к серверу Redis

Возвращает

boolean
True, если сервер Redis подключен

add()source public

add( string $key , mixed $value )

Записывает данные для ключа в кеш, если ключ ещё не существует. Если ключ уже существует, возвращает false.

Параметры

строка $key
Идентификатор данных.
смешанный $value
Данные для кеширования.

Возвращает

boolean
True, если данные успешно кешированы, false в случае ошибки.

Ссылка

https://github.com/phpredis/phpredis#setnx

Переопределяет

Cake\Cache\CacheEngine::add()

clear()source public

clear( boolean $check )

Удаляет все ключи из кеша

Параметры

boolean $check
Если true, будет проверка срока действия, в противном случае удаляются все ключи.

Возвращает

boolean
True, если кеш успешно очищен, 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|integer
Новое уменьшенное значение, false в противном случае

delete()source public

delete( string $key )

Удаляет ключ из кеша

Параметры

строка $key
Идентификатор данных

Возвращает

boolean
True, если значение было успешно удалено, false, если значение не существовало или не удалось удалить

groups()source public

groups( )

Возвращает group value для каждой из настроенных групп. Если начальное значение группы не найдено, то оно инициализируется соответствующим образом.

Возвращает

массив

Переопределяет

Cake\Cache\CacheEngine::groups()

increment()source public

increment( string $key , integer $offset 1 )

Увеличивает значение целочисленного кешированного ключа и обновляет время истечения срока действия

Параметры

строка $key
Идентификатор данных
целое число $offset необязательно 1
На сколько увеличить

Возвращает

boolean|integer
Новое увеличенное значение, false в противном случае

init()source public

init( array $config [] )

Инициализирует движок кеширования

Вызывается автоматически фронтендом кеша

Параметры

массив $config необязательно []
массив настроек для движка

Возвращает

boolean
True, если движок успешно инициализирован, false в противном случае

Переопределяет

Cake\Cache\CacheEngine::init()

read()source public

read( string $key )

Считывает ключ из кеша

Параметры

строка $key
Идентификатор данных

Возвращает

смешанный
Кешированные данные или false, если данных нет, срок действия истек или произошла ошибка при получении

write()source public

write( string $key , mixed $value )

Записывает данные для ключа в кеш.

Параметры

строка $key
Идентификатор данных
смешанный $value
Данные для кеширования

Возвращает

boolean
True, если данные успешно кешированы, false в случае ошибки

Наследованные методы из Cake\Cache\CacheEngine

_key()source protected

_key( string $key )

Генерирует безопасный ключ, учитывая настроенный префикс ключа

Параметры

строка $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|string
строка ключа или false

readMany()source public

readMany( array $keys )

Чтение нескольких ключей из кэша

Параметры

массив $keys
Массив идентификаторов данных

Возвращает

массив

Для каждого ключа кэша (указанного в качестве ключа массива) связанные данные кэша или false, если данные не существуют, истекли или произошла ошибка при их получении


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
Ключ для чтения.

Возвращает

mixed

_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.

Возвращает

mixed
Значение конфигурации, которое читается, или сам объект при операциях записи.

Исключения

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
Возвращаемое значение, когда ключ не существует.

Возвращает

mixed
Значение конфигурации, которое читается.

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
При попытке установить недействительный ключ.

Подробности свойств

$_Redissource

protected Redis

Обёртка Redis.

END_OF_DOCUMENT_MARKER

$_defaultConfigsource

protected array

Значение по умолчанию для конфигурации, используемое, если оно не переопределено конфигурацией во время выполнения

  • database номер базы данных для подключения.
  • duration Указывает, как долго элементы в этой конфигурации кэша сохраняются.
  • groups Список групп или 'тегов', связанных с каждым ключом, хранящимся в этой конфигурации. Полезно для удаления целой группы из кэша.
  • password Пароль сервера Redis.
  • persistent Подключение к серверу Redis с постоянным соединением
  • port Номер порта сервера Redis.
  • prefix Префикс, добавляемый ко всем записям. Полезно, когда вам нужно использовать один и тот же пространство имен с другой конфигурацией кэша или другим приложением.
  • probability Вероятность запуска очистки кэша gc. Установка в 0 отключит автоматический вызов cache::gc.
  • server URL или 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–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.RedisEngine.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API