Класс ArrayEngine
Двигатель хранения массивов для кэша.
На самом деле не является постоянным двигателем кэша. Все данные хранятся только в памяти на время одного процесса. Хотя он не подходит для производственных сред, этот двигатель может быть полезен в тестах или консольных инструментах, где вы не хотите избыточной нагрузки от взаимодействия с серверами кэша, но хотите сохранить преимущества работы с кэшем.
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\ArrayEngine
Краткое описание свойств
-
$dataprotectedДанные кэша.array
Унаследованные свойства
Краткое описание методов
- clear() publicУдалить все ключи из кэша. Это очистит каждую конфигурацию кэша, использующую APC.
- clearGroup() public
Увеличивает значение группы, чтобы имитировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока действия.
- decrement() publicУменьшает значение целочисленного ключа кэша
- delete() publicУдалить ключ из кэша
- groups() public
Возвращает
group valueдля каждой из настроенных групп. Если начальное значение группы не найдено, то оно инициализируется соответствующим образом. - increment() publicУвеличивает значение целочисленного ключа кэша
- read() publicПрочитать ключ из кэша
- write() publicЗаписать данные для ключа в кэш
Подробное описание методов
clear()source public
clear( boolean $check )
Удалить все ключи из кэша. Это очистит каждую конфигурацию кэша, использующую APC.
Параметры
- boolean
$check - Неиспользуемый аргумент, необходимый интерфейсом.
Возвращает
booleanTrue Возвращает true.
clearGroup()source public
clearGroup( string $group )
Увеличивает значение группы, чтобы имитировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока действия.
Параметры
- string
$group - Группа для очистки.
Возвращает
booleansuccess
Переопределяет
Cake\Cache\CacheEngine::clearGroup() decrement()source public
decrement( string $key , integer $offset = 1 )
Уменьшает значение целочисленного ключа кэша
Параметры
- string
$key - Идентификатор данных
- integer
$offsetoptional 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
$offsetoptional 1 - На сколько увеличить
Возвращает
boolean|integerНовое увеличенное значение, иначе false
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
$expiresoptional null - [необязательно] Отметка времени истечения срока действия, делая все данные до неё недействительными.
init()source public
init( array $config = [] )
Инициализировать движок кэша
Вызывается автоматически фронт-эндом кэша. Объединяет конфигурацию runtime с значениями по умолчанию перед использованием.
Параметры
- array
$configoptional [] - Ассоциативный массив параметров для движка
Возвращает
booleanTrue, если движок успешно инициализирован, иначе false
key()source public
key( string $key )
Генерирует безопасный ключ для использования с хранилищами кэша.
Параметры
- строка
$key - переданный ключ
Возвращает
boolean|строкаключ или false
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 - Значение для записи.
- boolean|строка
$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 - Значение для установки.
- 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 - Возвращаемое значение, когда ключ не существует.
Возвращает
смешанный типДанные конфигурации по указанному ключу или 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При попытке установить неверный ключ.
Подробное описание свойств
$datasource
protected массив
Данные кэша.
Структурированы как [ключ => [exp => срок действия, val => значение]]
[]
© 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.8/class-Cake.Cache.Engine.ArrayEngine.html