Класс ApcEngine
Двигатель кеша APC для хранения данных
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\ApcEngine
Краткое описание свойств
-
$_compiledGroupNamesprotectedarrayСодержит скомпилированные имена групп (с префиксом из глобальной конфигурации)
Унаследованные свойства
Краткое описание методов
- add() public
Записать данные для ключа в кеш, если он ещё не существует. Если ключ уже существует, то операция провалится и вернёт false.
- clear() publicУдалить все ключи из кеша. Это очистит все конфигурации кеша, использующие APC.
- clearGroup() public
Увеличивает значение группы, чтобы смоделировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока их действия.
- decrement() publicУменьшает значение целочисленного кешированного ключа
- delete() publicУдалить ключ из кеша
- groups() public
Возвращает
group valueдля каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответствующим образом. - increment() publicУвеличивает значение целочисленного кешированного ключа
- init() publicИнициализировать движок кеша
- read() publicПрочитать ключ из кеша
- write() publicЗаписать данные для ключа в кеш
Подробное описание методов
add()source public
add( string $key , mixed $value )
Записать данные для ключа в кеш, если он ещё не существует. Если ключ уже существует, то операция провалится и вернёт false.
Параметры
- строка
$key - Идентификатор данных.
- смешанный
$value - Данные для кеширования.
Возвращает
booleanTrue, если данные успешно кешированы, false в случае неудачи.
Ссылка
http://php.net/manual/en/function.apc-add.phpПереопределяет
Cake\Cache\CacheEngine::add() clear()source public
clear( boolean $check )
Удалить все ключи из кеша. Это очистит все конфигурации кеша, использующие APC.
Параметры
- логический
$check Если true, то ничего не будет очищено, так как записи удаляются из APC по истечении срока действия. Этот флаг используется только FileEngine.
Возвращает
booleanTrue
clearGroup()source public
clearGroup( string $group )
Увеличивает значение группы, чтобы смоделировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока их действия.
Параметры
- строка
$group - Группа для очистки.
Возвращает
booleansuccess
Переопределяет
Cake\Cache\CacheEngine::clearGroup() decrement()source public
decrement( string $key , integer $offset 1 )
Уменьшает значение целочисленного кешированного ключа
Параметры
- строка
$key - Идентификатор данных
- целое число
$offsetoptional 1 - На сколько уменьшить
Возвращает
boolean|integerНовое уменьшенное значение, false в противном случае
delete()source public
delete( string $key )
Удалить ключ из кеша
Параметры
- строка
$key - Идентификатор данных
Возвращает
booleanTrue, если значение успешно удалено, false, если его не существовало или не удалось удалить
groups()source public
groups( )
Возвращает group value для каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответствующим образом.
Возвращает
arrayПереопределяет
Cake\Cache\CacheEngine::groups() increment()source public
increment( string $key , integer $offset 1 )
Увеличивает значение целочисленного кешированного ключа
Параметры
- строка
$key - Идентификатор данных
- целое число
$offsetoptional 1 - На сколько увеличить
Возвращает
boolean|integerНовое увеличенное значение, false в противном случае
init()source public
init( array $config [] )
Инициализировать движок кеша
Вызывается автоматически фронтендом кеша
Параметры
- массив
$configoptional [] - массив настроек для движка
Возвращает
booleanTrue, если движок успешно инициализирован, false в противном случае
Переопределяет
Cake\Cache\CacheEngine::init() read()source public
read( string $key )
Прочитать ключ из кеша
Параметры
- строка
$key - Идентификатор данных
Возвращает
mixedКешированные данные или false, если данные не существуют, истекли или произошла ошибка при их получении
write()source public
write( string $key , mixed $value )
Записать данные для ключа в кеш
Параметры
- строка
$key - Идентификатор данных
- смешанный
$value - Данные для кеширования
Возвращает
booleanTrue, если данные успешно кешированы, false в случае неудачи
Методы унаследованные от Cake\Cache\CacheEngine
_key()source protected
_key( string $key )
Генерирует безопасный ключ, учитывая префикс ключа из настроек
Параметры
- строка
$key - переданный ключ
Возвращает
mixedstring $key или false
Исключения
InvalidArgumentExceptionЕсли значение ключа пустое
deleteMany()source public
deleteMany( array $keys )
Удаляет ключи из кеша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращает
arrayДля каждого переданного ключа кеша (в качестве ключа массива) true, если значение успешно удалено, false, если его не существовало или не удалось удалить
gc()source public
gc( integer|null $expires null )
Сбор мусора
Постоянно удаляет все истекшие и удалённые данные
Параметры
- integer|null
$expiresнеобязательно null - [необязательно] Отметка времени истечения, делающая все данные, более ранние чем данное значение, недействительными.
key()source public
key( string $key )
Генерирует безопасный ключ для использования с движками хранения кэша.
Параметры
- string
$key - переданный ключ
Возвращает
boolean|stringстроковый ключ или false
readMany()source public
readMany( array $keys )
Чтение нескольких ключей из кэша
Параметры
- array
$keys - Массив идентификаторов данных
Возвращает
arrayДля каждого ключа кэша (указанного в качестве ключа массива) ассоциированные данные кэша или false, если данные не существуют, истекли или произошла ошибка при их извлечении
writeMany()source public
writeMany( array $data )
Запись данных для многих ключей в кэш
Параметры
- array
$data - Массив данных для хранения в кэше
Возвращает
arrayМассив булевых значений для каждого ключа, true, если данные были успешно сохранены в кэше, false в случае ошибки
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаление одного ключа конфигурации
Параметры
- string
$key - Ключ для удаления.
Выбрасывает
Cake\Core\Exception\Exceptionесли попытка перезаписать существующую конфигурацию
_configRead()source protected
_configRead( string|null $key )
Чтение переменной конфигурации
Параметры
- string|null
$key - Ключ для чтения.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Запись переменной конфигурации
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$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']);
Параметры
- string|array|null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- mixed|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->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких параметров конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или полный массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this Объект.
Подробности свойств
$_compiledGroupNamessource
protected массив
Содержит скомпилированные имена групп (префиксрованные глобальным префиксом конфигурации)
[]
© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.Cache.Engine.ApcEngine.html