Класс 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
- Удаляет ключ из кэша
-
Возвращает значения
group valueдля каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответственно. -
Увеличивает значение целочисленного кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0
- Инициализирует движок кэша
- Считывает ключ из кэша
- Записывает данные для ключа в кэш
Подробное описание методов
_auth()source protected устарел
_auth( boolean $reverse = false )
Заполняет и инвертирует значения аутентификации $_SERVER Изменяет необходимые значения (и возвращает их обратно) в $_SERVER
Это необходимо, так как xcache_clear_cache() требует передачи аутентификации Basic 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( )
Возвращает значения для каждой из настроенных групп. Если начальное значение группы не найдено, то группа инициализируется соответственно.
Возвращает
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 )
Добавить ключ в кэш, если он еще не существует.
По умолчанию используется неатомная реализация. Подклассы должны отдавать предпочтение атомным реализациям.
Параметры
- строка
$key - Идентификатор данных.
- смешанный
$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, если данные не существуют, истекли срок действия или при возникновении ошибки при их получении
warning()source protected
warning( string $message )
Движки кэша могут генерировать предупреждения, если они обнаруживают сбои во время работы, если параметр warnOnWriteFailures установлен в true.
Параметры
- строка
$message - Сообщение об ошибке.
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 - Значение для записи.
- boolean|строка
$mergeнеобязательно 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']);
Параметры
- строка|массив|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->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или весь массив конфигураций.
- смешанный|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'); Параметры
- строка|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- смешанный
$defaultнеобязательно null - Возвращаемое значение, когда ключ не существует.
Возвращает
смешанныйДанные конфигурации по указанному ключу или null, если ключ не существует.
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']);
Параметры
- строка|массив
$key - Ключ для установки или весь массив конфигураций.
- смешанный|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно 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.8/class-Cake.Cache.Engine.XcacheEngine.html