Класс ApcEngine
Двигатель кэша APC для хранения данных
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\ApcEngine
Краткое описание свойств
-
$_compiledGroupNamesprotectedstring[]Содержит скомпилированные имена групп (с префиксом из глобальных настроек)
Наследованные свойства
Краткое описание методов
- 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 в случае неудачи.
Ссылка
https://secure.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 - Группа для очистки.
Возвращает
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 или false
Исключения
InvalidArgumentExceptionЕсли значение ключа пустое
deleteMany()source public
deleteMany( array $keys )
Удаляет ключи из кэша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращает
массивДля каждого предоставленного ключа кэша (возвращается в качестве ключа массива) 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']);
Устарело
3.4.0 использовать setConfig()/getConfig() вместо этого.Параметры
- 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->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или массив всех настроек.
- mixed|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'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- mixed
$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']);
Параметры
- string|array
$key - Ключ для установки или массив всех настроек.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Производить ли рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробности свойств
$_compiledGroupNamessource
protected string[]
Содержит скомпилированные имена групп (с префиксом глобального префикса конфигурации)
[]
© 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.ApcEngine.html