Класс 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() нужно передать аутентификацию Basic Http Auth (см. конфигурацию 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 - передаваемый ключ
Возвращает
mixedстрока $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 - переданный ключ
Возвращает
булево значение|строкастроковый ключ или 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 - Ключ для чтения.
Возвращает
смешанный тип_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Запись переменной конфигурации
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный тип
$value - Значение для записи.
- булево значение|строка
$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 - Значение для установки.
- булево значение
$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Вероятность запуска очистки кэша сборки мусора. Установка в 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–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.XcacheEngine.html