Класс XcacheEngine
Xcache движок хранения кеша
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\XcacheEngine
Ссылка: Xcache
Устаревший: 3.6.0 Движок Xcache устарел и будет удалён в 4.0.0.
Расположение: Cache/Engine/XcacheEngine.php
Краткое описание свойств
-
$_defaultConfigprotectedПо умолчанию конфигурация, если не переопределена конфигурацией во время выполненияarray
Унаследованные свойства
Краткое описание методов
-
Заполняет и меняет местами значения аутентификации $_SERVER Выполняет необходимые изменения (и откат) в $_SERVER
- Удалить все ключи из кеша
-
Увеличивает значение группы, чтобы смоделировать удаление всех ключей в группе старые значения останутся в хранилище до истечения срока действия.
-
Уменьшает значение целочисленного кешированного ключа. Если кешированный ключ не является целым числом, он будет обработан как 0
- Удалить ключ из кеша
-
Возвращает значения для каждой из настроенных групп Если начальное значение группы не найдено, оно инициализируется соответствующим образом.
-
Увеличивает значение целочисленного кешированного ключа Если кешированный ключ не является целым числом, он будет обработан как 0
- Инициализировать движок кеша
- Прочитать ключ из кеша
- Записать данные для ключа в кеш
Подробное описание методов
_auth()source protected deprecated
_auth( boolean $reverse = false )
Заполняет и меняет местами значения аутентификации $_SERVER Выполняет необходимые изменения (и откат) в $_SERVER
Это необходимо, так как xcache_clear_cache() должен передавать Basic Http Auth (см. конфигурацию xcache.admin)
Параметры
- boolean
$reverseoptional false - Отменить изменения
clear()source public deprecated
clear( boolean $check )
Удалить все ключи из кеша
Параметры
- boolean
$check Если true, удаления не будут происходить, а вместо этого CakePHP будет полагаться на значения TTL ключей. Не используется для движка Xcache.
Возвращает
booleanTrue, если кеш был успешно очищен, иначе false
clearGroup()source public deprecated
clearGroup( string $group )
Увеличивает значение группы, чтобы смоделировать удаление всех ключей в группе старые значения останутся в хранилище до истечения срока действия.
Параметры
- string
$group - Группа для очистки.
Возвращает
booleanуспех
Переопределяет
Cake\Cache\CacheEngine::clearGroup() decrement()source public deprecated
decrement( string $key , integer $offset = 1 )
Уменьшает значение целочисленного кешированного ключа. Если кешированный ключ не является целым числом, он будет обработан как 0
Параметры
- string
$key - Идентификатор данных
- integer
$offsetoptional 1 - На сколько уменьшить
Возвращает
boolean|integerНовое уменьшенное значение, иначе false
delete()source public deprecated
delete( string $key )
Удалить ключ из кеша
Параметры
- string
$key - Идентификатор данных
Возвращает
booleanTrue, если значение было успешно удалено, false, если его не существовало или его нельзя было удалить
groups()source public deprecated
groups( )
Возвращает значения для каждой из настроенных групп Если начальное значение группы не найдено, оно инициализируется соответствующим образом.
Возвращает
arrayПереопределяет
Cake\Cache\CacheEngine::groups() increment()source public deprecated
increment( string $key , integer $offset = 1 )
Увеличивает значение целочисленного кешированного ключа Если кешированный ключ не является целым числом, он будет обработан как 0
Параметры
- string
$key - Идентификатор данных
- integer
$offsetoptional 1 - На сколько увеличить
Возвращает
boolean|integerНовое увеличенное значение, иначе false
init()source public deprecated
init( array $config = [] )
Инициализировать движок кеша
Вызывается автоматически интерфейсом кеширования
Параметры
- array
$configoptional [] - массив настроек для движка
Возвращает
booleanTrue, если движок был успешно инициализирован, иначе false
Переопределяет
Cake\Cache\CacheEngine::init() read()source public deprecated
read( string $key )
Прочитать ключ из кеша
Параметры
- string
$key - Идентификатор данных
Возвращает
mixedКешированные данные или false, если данные не существуют, срок действия истек или произошла ошибка при их извлечении
write()source public deprecated
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 - [необязательно] Отметка времени истечения срока действия, делающая недействительными все данные до нее.
key()source public
key( string $key )
Генерирует безопасный ключ для использования с движками хранения кэша.
Параметры
- string
$key - переданный ключ
Возвращает
boolean|stringстрока ключа или false
readMany()source public
readMany( array $keys )
Чтение нескольких ключей из кэша
Параметры
- array
$keys - Массив идентификаторов данных
Возвращает
arrayДля каждого ключа кэша (переданного как ключ массива) связанные данные кэша или false, если данных нет, они просрочены или произошла ошибка при их извлечении
warning()source protected
warning( string $message )
Движки кэша могут генерировать предупреждения, если они обнаруживают сбои во время работы, если параметр warnOnWriteFailures установлен в true.
Параметры
- string
$message - Сообщение предупреждения.
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
$mergeoptional 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']);
Параметры
- string|array|null
$keyoptional null - Ключ для получения/установки или весь массив настроек.
- mixed|null
$valueoptional null - Значение для установки.
- boolean
$mergeoptional 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
$valueoptional 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
$keyoptional null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultoptional 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
$valueoptional null - Значение для установки.
- boolean
$mergeoptional true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Подробности свойств
$_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–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.6/class-Cake.Cache.Engine.XcacheEngine.html