Класс XcacheEngine
Двигатель хранения Xcache для кэша
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\XcacheEngine
Краткое описание свойств
-
$_defaultConfigprotectedЗначение конфигурации по умолчанию, если не переопределено в конфигурации выполненияarray
Унаследованные свойства
Краткое описание методов
- _auth() protected
Заполняет и инвертирует значения аутентификации $_SERVER. Вносит необходимые изменения (и отменяет их) в $_SERVER
- clear() publicУдалить все ключи из кэша
- clearGroup() public
Увеличивает значение группы, чтобы имитировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока действия.
- decrement() public
Уменьшает значение целочисленного кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0
- delete() publicУдалить ключ из кэша
- groups() public
Возвращает
group valueдля каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответствующим образом. - increment() public
Увеличивает значение целочисленного кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0
- init() publicИнициализировать движок кэша
- read() publicПрочитать ключ из кэша
- write() publicЗаписать данные для ключа в кэш
Подробное описание методов
_auth()source protected
_auth( boolean $reverse false )
Заполняет и инвертирует значения аутентификации $_SERVER. Вносит необходимые изменения (и отменяет их) в $_SERVER
Это необходимо сделать, так как xcache_clear_cache() должен передавать базовую аутентификацию HTTP (см. конфигурацию xcache.admin)
Параметры
- boolean
$reverseнеобязательно false - Отменить изменения
clear()source public
clear( boolean $check )
Удалить все ключи из кэша
Параметры
- boolean
$check Если true, удаление не произойдёт, и вместо этого CakePHP будет полагаться на значения TTL ключа. Не используется для движка Xcache.
Возвращаемое значение
booleanTrue, если кэш успешно очищен, в противном случае false
clearGroup()source public
clearGroup( string $group )
Увеличивает значение группы, чтобы имитировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока действия.
Параметры
- string
$group - Группа для очистки.
Возвращаемое значение
booleanуспех
Переопределяет
Cake\Cache\CacheEngine::clearGroup() decrement()source public
decrement( string $key , integer $offset 1 )
Уменьшает значение целочисленного кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0
Параметры
- string
$key - Идентификатор данных
- integer
$offsetнеобязательно 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 )
Увеличивает значение целочисленного кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0
Параметры
- string
$key - Идентификатор данных
- integer
$offsetнеобязательно 1 - На сколько увеличить
Возвращаемое значение
boolean|integerНовое увеличенное значение, в противном случае false
init()source public
init( array $config [] )
Инициализировать движок кэша
Вызывается автоматически фронтендом кэша
Параметры
- array
$configнеобязательно [] - массив настроек для движка
Возвращаемое значение
booleanTrue, если движок успешно инициализирован, в противном случае false
Переопределяет
Cake\Cache\CacheEngine::init() 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 - переданный ключ
Возвращаемое значение
mixedstring $key или false
Исключения
InvalidArgumentExceptionЕсли значение ключа пустое
add()source public
add( string $key , mixed $value )
Добавить ключ в кэш, если он ещё не существует.
По умолчанию используется неатомарная реализация. Подклассы должны предпочитать атомарные реализации.
Параметры
- string
$key - Идентификатор данных.
- mixed
$value - Данные для кэширования.
Возвращаемое значение
booleanTrue, если данные были успешно кэшированы, false при ошибке.
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|строкаключ или false
readMany()source public
readMany( array $keys )
Чтение нескольких ключей из кэша
Параметры
- массив
$keys - Массив идентификаторов данных
Возвращает
массивДля каждого ключа кэша (указанного в качестве ключа массива) данные кэша или false, если данные не существуют, истекли или произошла ошибка при их извлечении
writeMany()source public
writeMany( array $data )
Запись данных для многих ключей в кэш
Параметры
- массив
$data - Массив данных для хранения в кэше
Возвращает
массивзначений boolean для каждого предоставленного ключа, 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
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']);
Параметры
- строка|массив|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->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или весь массив конфигураций.
- смешанный тип|null
$valueнеобязательный null - Значение для установки.
Возвращает
$this Объект самого себя.
Подробное описание свойств
$_defaultConfigsource
protected массив
Конфигурация по умолчанию, используемая, если её не переопределено во время выполнения
-
durationУкажите, как долго элементы в этой конфигурации кэша сохраняются. -
groupsСписок групп или «метках», связанных с каждым ключом, хранящимся в этой конфигурации. полезно для удаления целой группы из кэша. -
prefixПрефикс, добавляемый ко всем записям. Хорошо подходит, когда вам нужно совместно использовать пространство ключей с другой конфигурацией кэша или другим приложением. -
probabilityВероятность запуска очистки кэша gc. Установка в 0 отключит автоматический вызов cache::gc. -
PHP_AUTH_USERxcache.admin.user -
PHP_AUTH_PWxcache.admin.password
[
'duration' => 3600,
'groups' => [],
'prefix' => null,
'probability' => 100,
'PHP_AUTH_USER' => 'user',
'PHP_AUTH_PW' => 'password'
]
© 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.3/class-Cake.Cache.Engine.XcacheEngine.html